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ae 


1.1 


INTRODUCTION AND OVERVIEW 


BACKGROUND 


The Logical Link Control Layer for LACS oftware and Hardware 
development is designed and implemented to meet IEEE 802.2 
Standard. The logical link layer is the conceptual layer of 
control or processing logic existing in the hierachical structure 
of a station that is responsible for maintaining control of the 
data link. The logical link layer functions provide an interface 
between the station higher layer logic and the data link. These 
functions include address/control field interpretation, channel 
access and command PDU/response PDU generation, transmission and 
interpretation. 


The IEEE 802 standard identifies two distinct "classes" of LLC 


operation Currently, we support Class I which provides 
data-link-connectionless service only. (Class II provides 
data-link-connection-oriented service plus 


data-link-connectionless service, this will be support later). 


In the IEEE 802 model, the LLC sublayer is responsible for 
Supporting logical access points called LSAPs. The sublayer 
accepts write primitives from the Network layer above and formats 
them into write primitives for the MAC sublayer below. Incoming 
data in the form of indicate primitives from the MAC sublayer are 
prepared for the Network layer. Addresses associated with each 
layer are either added or removed as iS appropriate for the 
direction of data flow and the layer involved. 
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The service of the Logical Link Layer is the capabilities which it 
offers to a user in the next higher layer (or lower layer) . In 
order to provide its services, LLC layer builts its functions on 
the services which it requires from the next lower layer (MAC 
layer). The LLC layer'’s primitive services are: 


REQUEST 
The request primitive is passed from the LLC layer's 
user (it could be the higher layer: Level 6, or 
Network layer, or Transport layer, or could be the 
lower layer: MAC layer), to the LLC layer's sublayer 
to request that a service be initiated. 
INDICATION 
The indication primitive is passed from the LLC 
layer's sublayer to the LLC layer's user to indicate 
an event which is significant to the LLC layer's 
user. This event may be logically related to a remote 
servicerequest, or may be cause by an event internal 
to the LLC sublayer. | 
| ; CONFIRM 


ae The confirm primitive is passed from the LLC layer to 
the LLC layer’s user to convey the results of one or 
more associated previous service request(s). This 
primitive may indicate either failure to comply or 
some level of compliance. It does not necessarily 
indicate any activity at the remote peer interface. 
IN THE CURRENT RELEASE, WE “DO NOT USE THIS 
MECHANISM TO HANDLE THE LAYER INDICATION. 


The Logical service access points called LSAPsS are managed by 
the LLC sublayer and the LLC sublayer management services. 
Communications take place between local LSAPsS and their peer 
enities, remote LSAPs, in the form of protocol data units (PDU). 
The Network layer or layers above LLC will select and use LSAPs 
to route messages to and from Network (or SubNetwork, or 
Transport) service access points called NSAPs (or TSAP’s). 
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1.3 


provided by a set of 3 processes 


BASIC STRUCTURE 


Sublayer Management functions are 
that run under the Bridge Kernel 


The LLC Sublayer and the LLC 


operating system. The 3 processes are a layer -management 
process (LM), a transmit process (XMT) and a receive process 
(RCV). Fach process will have public access to tables that 
contain the state and status of the process itself as well as 


the various service access points (SAPs). 


The mailboxes for a LLC Layer instance interface with the 
megabus software, the MAC layer and System Management. A 
mailbox will be created for each interface as follows. 


Mailbox Names 
(For Layer Instance 0-3) 
Layer Management LM 
default mailbox 
LNMLME 
LLC_LMO 
LLC_LM1 
LLC _LM2 
LLC_LM3 
Default mailbox for the LM process. All 
System Management messages arrive here and 


alarm messages returned from the kernel are. 


routed here. 


Default mailbox for 
Transmit process XMIT 


lic _ tx0 
lic txl 
llc tx2 
lle _tx3 
Layer Management messages from LLC LM to 
transmit process LLC XMIT arrive here. 
Default mailbox for 
Receive process RCV 
lic rx0 
lle _rxl 
lic rx2 
llc _rx3 
Layer Management messages from LLC LM to 


receive process LLC RCV arrive here. 


Megabus mbx 
IODISP 
MEMDMA 
IOLD messages and returning DMA requests 
arrive here. 


MAC DATA.indication messages and returning 


MAC Data mbx = 
MAC_DATA.request messages arrive here. 
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( 1.4 BASIC OPERATION 


The Logical Link Control Layer in the IEEE 802 Local Area Network 
Protocol is common to the various medium access methods that are 
defined and supported by the IEEE 802 activity. 


The Logical Link Control Layer interface service to the Network 
(Transport) Layer provides various services that the LLC layer, 
plus underlying layers and sublayer, offer to the Network 
(Transport) layer, as viewed from the Network (Transport) layer. 
These services are defined so as to be independent of the form of 
the medium access methodology, and of the nature of the medium 
itself. 


In order to Support the LACS, a software driver will be written 
for the DPS 6 to provide the interface to the different layers. [In 
addition to this, System Management facilities will be provided in 
the DPS 6 and LACS to help control and administer the local LACS 
as well as the entire network. 
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The following diagrams illustrate the Logical Link Layer serves to 
different configuration of Local Area Network Protocals 


_LLe LAYER AT THE CURRENT RELEASE LAN CONFIGURATION 


DPS 6 USER 
(MOD 400 4.1 Operating System) 


Distributed System Architecture 


(Honeywell DSA Network System) 


$ssi2-< {==== LACS Megabus Interface Module (DMA) [ aad 


| IOLD message | {Logical Control Blk | Rw 
LOGICAL LINK CONTROL LAYER 


> 
| MAC DATA INDICATE MESSAGE MAC DATA REQUEST MESSAGE 
+ 


___Instance-0  Instance-1]1 Instance-2__Instance-3 
ve~ [out ov * fouefove * foueftov 7 | 
$—————--— + $—— mm + $+————— = + $+ + 
=> Medium Medium Medium Medium 
== Access Access Access Access 
Control 


Physical 
Medium 0 


Manage 
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LLC LAYER AT THE NEXT RELEASE LAN CONFIGURATION 
(With Network, Transport layers) 


DPS 6 USER 
(MOD 400 4.1 Operating System) 


(Option) 
Distributed System Architecture 
(Honeywell DSA Network System) 


(Can be other User application) 


$4——----- = -- 5 + 5 5 5 5 5 5 = + = == ++ 
| Interface Level 6 Software | 
of on ee oe ee 5 = ++ 
| Megabus interface | 
$a an nn 5 5 5 + 5 = + = = = = - ++ 
+—----- {==== LACS Megabus Interface Module (DMA) 
| |--------|IOLD message |---|Logical Control Blk|-- 
+-------- + +--—+ — 
<====> Transport Layer . | 
| town a nnn nnn === | TRN Message |-------~----- ----- + 
<====> Network Layer | 
+-------- ~------- | Net Message | 
SME | LOGICAL LINK CONTROL LAYER 
+=) 
MAC DATA INDICATE MESSAGE MAC DATA REQUEST MESSAGE 
System<=+ Instance-0 Instance-l Instance=-2 Instance-3 
Manage| | v ~*~ [| [| vo * |uVfov * pup ow * po 
Module +<—-—------- + +-—------ + +-------- + $-------- + 
===> Medium Medium Medium Medium 
<=== Access Access Access Access 
| Control Control Control Control 
+------ + 0) 1 2 3 


Physical Physical Physical Physical 
Medium 0 Medium 1 Medium 2 Medium 3 
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Code for the LLC and LLC layer mamagement functions will be loaded | 
with the rest of the LACS board code and begin operating when the 
process has been activated by System Management. 
with other processes such as MAC or megabus 
will take the form of messages delivered to process mailboxes via 


services provided by the Kernel. 


LLC Layer Instance Block Diagram 


LLC LME 


Process 


(Megabus) (MAC_DATA) (Default) 


Interface indication SM 


LLC Receive 


Process 


Interface SM 


LLC Transmit 


Process 


(Megabus) (Default) 
Interface LME 


(Megabus) (MAC_DATA) (Default) 
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The Process for transmit is the following: 

recieve "xmit" LCB from level 6. 

Validate LCB. 

detect if data in LCB directly. If it is, go to step 5. 


If data is not in LCB, call DMA bring data buffer cross the 
MEGABUS interface from level 6. ; 


allocate llc trans block. 

convert LCB. data to transaction block. 

prepend the LLC header. 

send message LLC_PDU (llc trans) th MAC layer for transmit. 


Set up all statiatic counters. 
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The Process for recieve is of the following: | a 


™, 


There are three cases, recieve LCB arrival, PDU arrival, and XID 


/ 
( 


on 


y 


TEST response. 


TI. recieve LCB 


D 


recieve "READ" LCB from level 6. 


validate LCB. 


If PDU queue has waiting PDU block, then convert each of the 
PDU block (in the queue structure order) to LCB data format, 
andsend each one (in order) back to level 6. Untill PDU in 
queue are sent out completely. Complete the READ LCB. 


If PDU queue is empty, allocate READ LCB transaction block to 
transfer the LCB data to READ transaction block. Hang up the 
transaction block at the READ LCB queue. (If the queue is 
already full, drop this transaction block return the memory 
allocated). 


set statistic counter. 


II. recieve PDU 


De 
1 a 


1. 


Ze 


recieve PDU data block from MAC layer. 
validate PDU. If illigal PDU, drop it. 
If PDU is valid, strip the LLC header. 
convert PDU block to lle_trans block. If there are outstanding 
read LCB in the LCB queue, send PDU llc_trans block to level 6. 
If read LCB queue is empty, hang the PDU transaction block in 
the PDU queue. If the queue is full, drop the PDU, and clean 
the PDU memory. 


update statistic counters. 


recieve XID/TEST: 


upon receipt of an XID command PDU from MAC prepare and send 
response XID PDU to requesting station. 


upon receipt of a TEST command PDU from MAC prepare and send 
response TEST PDU to requesting station. 


Honeywell Infomation Systems 
Page -13- 


LOGICAL LINK CONTROL LAYER (IEEE 802.2, in LACS) 


. 2.1 OWNED DATA STRUCTURES 


Component Specification 


LOGICAL LINK LAYER EXTERNAL SPECIFICATION 


Fach process in the set that make up a LLC layer instance will 
have access to layer data structures via an Instance Common Area. 
Pointers to local and remote LSAP tables, the IOLD function 
directory, and mailbox IDs for the various interfaces will all be 
contained in the Instance Common Area. 


Layer Instance Common Area 


Data structure type LICAs: 
Data Structure discription LLC Layer entry name 


Function directory mailbox ID array 
Recieve default mailbox 

Receive mailbox 

Receive MAC data indication 
Megabus DMA mailbox ID "MEMDMA" 
Megabus IO Dipatcher ID "IODISP" 
Controller layer MGR ID "LNMLME" 
Transmit default mailbox 
Transmit mailbox 

LLC layer LME mailbox 

System MGR event mailbox 

MAC data request mailbox 

MAC activate mailbox 


Number of local sap dir entries 
LSAP table pointer array 

Number of remote sap dir entries 
Index to next free entry in remote 
Remote LSAP table pointer array 


Emergency event message pointer 
PDUs to undefined remote LSAPs 


Layer instance major state 

Layer instance substate 

Max PDU size for the layer instance 
Layer instance number 

Layer number 

Layer instance init step 


fc mbx dir[16] 
cx default 
rx mbx 

cx mac 
dma_mbx 
Lodisp mbx 
ct _lm_mbx 
tx _default 
xmit _mbx 
lme _mbx 
sm_event 
mac data 
mac _act_mbx 


1_lsap_dir_sz 
1_lsap dir 

r _lsap_ dir sz 
nxt r dir index 
r _lsap_ dir 


emer event 
ctr _und_pdu 


1li_majorstate 
li_substate 
max _pdu_sz 
inst numbr 
layer 

init step 
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Unknown error counter 
IOLDs counter for layer manager 


LCB to 
LCB to 


level 6 counter for LM 
lacs counter for receive 


IOLDs counter for receive 


LCB to 
LCB to 


level 6 counter for receive 
lacs counter for receive 


IOLDS counter for xmit 


LCB to 
LCB to 
Buffer 
Buffer 
Number 
Number 


level 6 counter for xmit 
lacs counter for xmit 

to level 6 counter 

to lacs counter | 

of xmit PDU dropped 

of receive PDU dropped 


Component Specification 


ctr_unk_err 
ctr IOLDs 1 
Cre eLCR.. 16 1 
ctreLCB_ lac eb. 
os alle IOLDS r_ 
Cer; _LCB_ 16 r 
ctr ~LCB lac 4 
on al ~IOLDsS x, 
ctr _LCB_ 16 x 
ctr _LCB “lac x 
ctr BUF 16 — 
ctr BUF lac 
ctr PDUd tx 
ctr PDUd rx 
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2.1.1 LLC Local SAP Components 


LSAPS are represented in the LLC layer by SAP componemt tables. 
The table is created when directed by System management and 
exsist until deleted by system management messages. SAP 
Component tables will contain the following entries. 


Data Structure discription LLC Layer entry name 


LSAP symbolic name 


lsap_name[16] 


class of LSAP class 

LSAP type type[4] 
LSAP venue venue 
Major administrative state majorstate 
LSAP sub administrative state substate 
MAC instance number mac_inst 
Length of MAC address (bytes) mac_adr_ lngth 
LSAP address (8 bits) lsap_adr 
MAC address for this lsap (48 bits) mac adr([6] 
IEEE 802.2 states 1802 st 
IEEE 802.2 type type vct 
Logical local LSAP address log adr 


SAP indicator and flag word sap_ind flag 


Pointer to event LCB | event trans 
Event indicator and flag word event_ind flag 


Network layer mailbox for this sap net _mbx 


Current number of active remote sap cur_num_rmts 
pointer to activate remote sap dir r act dir © 


Max transmit bytes 
Max receive bytes 
Max rtransmit credit 


max xmit_bytes 
max _rcv_ bytes 
max tx credit 
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Receive LCB queue counter rcvq_lcb count 
Receive PDU queue counter rcvq _pdu_count 
Transmit LCB queue counter xmitq_ lcb _count 
Transmit PDU queue counter xmitgq _pdu_, count 
Actual transmit credit act _xmit_ credit 
Actual receive credit act rev credit 
Max PDU size max pdsz 

First LCBI transaction in queue lcb fwd 

LCBI root back pointer lcb bwd 

Dummy LCB last forward in queue lcb end f 
Dummy LCB last backward in queue lcb end b 
First PDU message in queue pdu_fwd- 

PDU root back pointer odu _bwd 
Dummy PDU last forward in queue pdu_ ~end f 
Dummy PDU last backward in queue pdu__ ~end _b 
First EVENT transaction in queue evn f 

EVENT root back pointer evn _b 

Dummy EVENT last forward in queue evn _end £ 
Dummy EVENT last backward in queue evn _end_ ~b 
Array if IEEE 802 group address grp_addr [64] 
Number of data octets transmitted ctr do tx 
Number of data octets received ctr _do_ _IxX 
Number of frames with unknown command ctr _uk or 
Number of LCB transmitted ctr _LCB_ tx 
Number of LCB received | ctr LCB rx 
Number of receive connection IOLDs ctr LOLDs _re 
Number of event IOLDs 4 ae IOLDs | _ev 
Number of active IOLDs cir. IOLDs _ _ac 
Number of UI frames transmitted ctr _UI 2 a 
Number of UI frames received ctr _UI_ _Yx 
Number of XID commands transmitted ctr XIDc_ tx 
Number of XID commands received ctr XIDc_ rx 
Number of XID responses transmitted ctr XIDr_ tx 
Number of XID responses received ctr XIDr rx 
Number of TEST commands transmitted ctr _TESTc_ tx 
Number of TEST commands received ctr TESTc_ rx 
Number of TEST responses transmitted ctr TESTr tx 
Number of TEST responses received ctr TESTr rx 
Number of transmitt PDU dropped ctr PDUd tx 
Number of receive PDU dropped ctr PDUd_ rx 
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( IEEE802 Private states(DSA) 
IN_USE 
ENABLED 
DISABLED 
LOCKED 
TEST 
SHUTDOWN 


2.1.2 IEEE 802 Connection Components 


Connection oriented service is not 
implmentation. 


Honeywell Infomation Systems 
Page -18- 


provided 


in 


this 


LOGICAL LINK CONTROL LAYER (IEEE 802.2, in LACS) Component Specification 


2.1.3 LLC Layer LCBI Formats 


The portion 
is all that 
structures 


of the LCB actually 
is used by 


are used to locate and 


modify portions . 


fe 
fe 


transferred across the megabus 
LACS board code. 


code 
LCB 


Equivalent 'C' 
of the 


/ 


while the image is resident on the LACS board. The format for 
LACS resident LCB blocks, known as LCBIs, is given below in 'C' 

notation. Be aware that this structure represents’ only the 
portion of the L6 defined LCB that is actually transferred 
across the megabus. 

Data Structure discription LLC Layer entry name 

Interrupt control word cbicw 

Function specific function code cbfs€f' 

Buffer indicators cbind 

Total Byte range cbtrg 

Number of buffer cbboct 

BUFFER DESCRIPTOR cbhdes [3] 

Buffer address buf_adr 

Buffer indicator buf_ind 

Buffer range buf rng 

Buffer residule range buf_rsr 

LCBI TYPES lebi_type ms 

i 

Generic LCBI block generic lcbi 

Reserved spaces cb_s[32] 

Activate local LCBI act_1_ lcbi 

Symbolic name cbsym[16] 

Proposed read max credit cbpre 

Proposed read SDU size cbpms 

Reserved spaces cb s[12] 

Maximum SDU size cbmss 

Ideal SDU size cbiss 

Max pending read count cbmpr 

Write credit count cbwec 

Maximum number connections cbmcc 

Logical address - local sap selector cblsa 

Deactivate local LCBI da_l_lcbi 

Logical address —- local sap selector cblsa 

Reserved spaces cb_s[30] 

Activate remote LCBI act_r_lcbi 

Logical address - local sap selector cblsa 

Symbolic name cbsym 

Reserved spaces cbrsv 

Reserved spaces cb s[18] 

cbIra a 


Remote logical address 
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Read LCBI information 

Local lsap logical address 

Reserved spaces 

Local actual buffer address 
SAP additional read credit 

Actual buffer size 

Remote sap indicator 

Remote logical address 


Write LCB information 
Logical locap sap address 
Remote logical address 
Class of service 

Reserved spaces 

Write credit 


Event LCBI information 

Connect indicate event information 
Function specification wd 
Quality of service 

Expidited data option 

Return sap indicator 

Logical remote address 
Connection id 

Data arrival event information 
Reserved spaces 

Actual buffer size 

Additional write credit event 
Reserved spaces 

Additional write credits 

SAP error event 
Reserved spaces 

SAP error reason code 


Controller status 
Indicator word 
Completion word 


in LACS) 


Component Specification 


read lcbi 


cblsa 


cb s[21] 


cblbs 


cbabs 
cblri 
cblra 


trans _lcbi 
cblsa- 


cblra 
cbcls 


cb s[26] 


cbawc 


event: lcbi 
cn_ind 
cb s23 


cbcls 
cbexd 
cbrsil 
cblra 
cbcid 


data arr 


cbs [6] 


cbabs 


add wc 


cb s[7]. 


cbhawc 


sap err’ 


cb _s[7] 


cbrcd 


cbcts 
cbfss 
cbocbs 
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2.1.4 Layer Function Directory a 


Entries in the Function Directory used by the LLC Layer Instance 
are limited to receive, transmit, activate, and event. 


2.1.5 Mesasge Formats 


According to the message MSG data structure definition of the 
Bridge Communication Kernel, the message common data structure is 
as follow: | 


Data Structure Description Kernel entry names 
Next message on circular list m_fwd 

Last message on circular list m_bwd 

Processid of sending process m_ sender 

Buffer description m_bufdes 

Urgent or normal m_prio 

User message type m_type 


2.1.6 MAC_DATA request message format 


The following is a generic Medium Acess Control Layer data 
request mwssage format for different MAC layers. 


Data Structure Description MAC-LLC entry names 
Normal message header mh 

Frame control channel frame_ctl 

Pointer to desc build area pkt_desc 

Return mailbox id return_id 

Return status field status 

Class of service parameters cl_of_srvc 

ether type field or 802.3 length type fld 

LAN destination address mac DA 


a 
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2.2 EXTERNAL INTERFACES 


As mentioned above, all interfaces with other processes on the 
LACS board will be by mailbox messages. All of the messages 


seen by the LLC process have their formats defined 
respective orocess. Consult the MAC layer, the 


by the 
megabus 


interface software, an the system management Services for the 


message formats. 


In the execution of a request by one of these layers, 


several 


steps involving exchanges of messages with other processes will 
take place. Once a message has been “mailed" to another process 
the context and state of the "transaction" is lost. Therefore 
some mechanism must be in place to retrieve the context and 
state when the next step is to be executed. The method used in 


this code consist of a “transaction block" message. 


The transaction block message is composed of a header area that 


is large enough to hold any of the messages’ that 


must be 


exchanged with other processes. After the header area, pointers 
to tables and values that are part of the transaction context 
become part of the transaction and are passed along with the 


message. 


Transaction blocks are created at two times, once when an IOLD 
is received and once when the MAC layer sends a data indicate 


message. _ 


Transaction blocks are used to send the following messages. 


LCBIO DMA request to move LCBs across the megabus 
BUFIO DMA requests to move buffers across the megabus 
CONFMSG —~ MAC _DATA.confirm messages 


L DATA msg L_DATA.request and .indication messages 


In addition, the transaction block carries pointers to the 
related to this transaction, the L6 memory address of the 
the length of the LCB, and the channel control word to be 


when the LCB is returned to the L6. 
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The Logical Link layer transaction block data structure is listed 
at the following. At the top of the structure is 


reduce the decoding and table lookup that would otherwise 
required. 

Data Structure discription LLC Layer entry name 

Transaction server serv 

Transaction blk queue pointers trn blk 

DMA requests for LCBIs lcbio - 

DMA requests for buffers bufio 

MAC DATA request messages mdr 

Pointer to a MAC data indicate msg mac_ind 

Data buffer descriptor pointer data_bd 

The length of LCBI lcbi_leng 

The channel involved lcb_ chan 

Pointer to the buffer descriptor 16 mem ptr 

Level 6 memory pointer to LCBI 16 mem _ptr 

Pointer to the buffer descriptor bdi _blk 

Level 6 memory pointer to buffer des. 16 bdi ptr 

Pointer ro the local LSAP table 1 _Isap_ ~ table 

Pointer to the remote LSAP table r _lsap_ ~ table 


Local logical address 


Remote logical 


address 


1 _log_ addr 
4 _log_ ~addr 


203 


INITIALIZATION REQUIREMENTS 


Tables that describe the adapter that 


LLC layer process 
will have been created by the 


and a SAP component 


is being supported by this 


for LLC Layer Management 


initialization code of the process 


when it is created by the layer management. 


24 


There are no termination requirements for the LLC 
will be active in one form or 


is active. 


TERMINATION REQUIREMENTS 


another as long as 


layer since it 
the LACS board 
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2.5 ENVIRONMENT 


All LLC layer functions will be coded in the 'C'’ language, 
compile to 68000 assembly language by the cc68 compiler, and _= run 
under the Bridge real time kernel. Macros and header files from 
the Bridge communication development environment will be used 
where they can without alteration. The LLC layer will also use 
the header files from the megabus interface software, the MAC 
layer, and system management to define message formats’ and 
content. Refer to the respective header files for the details. 


2.6 TIMING AND SIZE REQUIREMENTS 
The code should be as efficient as prosible. 
2.7/7 ASSEMBLY AND LINKING 


All source code for the LLC layer will be under the version and 
release control of the SCCS (Source Code Control System) 
facilities provide by the UNIX development environment and the 

| project source code administrator Assembler ad68 which is provided 

( by the Bridge Communication development is used. Linking will be 

bo : under the control of the master product Makefile used to combine 
all modules that constitute the product. Linker 1d68 which is 
provided by the Bridge Communication development is used. Refer to 
UCOS UNIX MENU and the Bridge Communication Software Specification 
for the detailed description of these facilities. 


2.8 TESTING CONSIDERATIONS 
All product’s sofeware functions are tested by the developer. 
2.9 DOCUMENTATION CONSIDERATIONS 


All LACS Logical Link Control Layer documentations will be written 
by follow the recommendations of The Honeywell software 
documentation guidelines. Also, all code design descriptions will 
be accompanied by a Procedural Design Language description. 
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2.10 OPERATING PROCEDURES | —_— 


ae * 


The LLC layer must recieve an IOLDS request before any other 
request take place. The emergency event transaction block 
should always availible for catastrophic error report event 
message in the case of kernel running out of memory. 
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2.11 ERROR MESSAGES 


2e-1ll.l 


Logical Link Control Layer errors can be divided into the 
Following classes: 


* Catastrophic Errors 
Unreportable Catastrophic Errors. 
. Refortable Catastrophic Errors. 


. Fatal Operartion Errors 
Fatal Operation Error that must be reported to the 
initiator or the operation. 
e Fatal Operation errors that must be reported to the 
initiator of the operation and as an event to the 
System Management. 


* Non-Fatal Operation errors. 
* Recoverable Errors. 
* Protocol Errors. 


* DPS6 System Error. 
ERROR CONDITION DEFINITIONS 


Unreportable catastrophic errors are errors where the integrity of 
the LACS .controller is corrupted sufficiently to warrant halting 
the LACS controller. Futhermore the controller cannot be trusted 
to event report the error. These are typically hardware errors 
such as parity error while executing instructions, LACS internal | 
bus errors. 


Reportable catastrophic errors are errors where the integrity of 
the LACS system 1s corrupted sucfficiently to halt the LACS but it 
is possible to make an effort to report the error. These are 
typically caused by software errors where the LACS system is not 
set up correctly. 


Fatal operational errors are errors which cause the process to 
abort the particular operation that it is performing and require 
that the layer server deactivate a SAP or disconnect a connection. 


Non-fatal operation errors are errors which cause the process to 
abort the particular operation that it is performing. 


Recoverable errors are errors which are temporary in nature 
typically caused by a temporary lack of controller resoiurce. 


The protocol errors and DPS-6 system errors do not fall in the 
classes described above. 
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2.11.2 ERROR CONDITION HANDLING 


For the unreportable catastrophic errors, the approach taken in 
handling such errors is to immediately halt all LACS processing in 
order to preserve the state of the LACS at the time of the errors 

occurence. The DPS6 detects a LACS fatal unreportable catastrophic 
error through the absence of any LACS response or as a result of 
exceeding the allowed limits for a IO instruction. There is a 
possibility that the LACS will not support a dump of it's memory 
due to the severity of a nonreportable catastrophic errors. 


If the errors are reportable catastrophic errors, any process 
detecting these errors must record the location and type of the 
error in a common area associated with the process and report it 
to the layer management process it associated ‘with. An error event 
indication is sent to LACS system management. The LACS system 
management process will attempt to report to the SM layer in the 
DPS 6. In the event that the system management process failed to 
report it to the DPS6, it will request the controller to halt the 
LACS. The controller process will also save an indication of the 
type of error in a known system area and set up the controller to 
all I/O orders. 
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2.11.3 ERROR MESSAGE CODES 


All errors that detected by the LLC layer are handled at the llc 
err routine. The Codes listed below included all detected error 


conditions. 


ERROR CODES(decimal) ERROR CONDITIONS LLC LAYER ERROR FLAGS 
~1 No match on a search address or name NO_MATCH 

-2 For error but not exit, to calling ERR_RETURN 

20 Bad function spec. function code BAD _FSFC 

22 Invalid function code INVALID FC 

24 Bad layer instance state BAD _ LAYER_ STATE 


26 Bad or unknown remote SAP 

28 Bad or unknown. local SAP 

30 SAP already active 

32 SAP deactivated 

34 Multiple activate requests on SAP 
36 Bad remote SAP state 

38 Bad local SAP state 

40 Create local LSAP error 

42 Create remote LSAP error 

44 SAP not available for services 
46 Bad DSAP in receive PDU 

48 Bad SSAP in receive PDU 

50 Bad DMA transfer of data buffer 
52 Bad DMA transfer of buffer descriptor 
54 Bad transmit request desc. 

56 Bad PDU size 

58 LCB buffer size too small for PDU 
60 Bad DSAP state 

62 PDU exceeds max PDU size 

64 Receive LCB, PDU queue full 

66 Invalid transfer 

68 Return LCB error 
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BAD_REMOTE_SAP 
BAD_LOCAL_SAP 
SAP ACTIVE 

SAP _DACTIVE 
MULTIPLE_ACT 
BAD_R_LSAP_STATE 
BAD_L_LSAP_ STATE 
CR_L_LSAP_ERR 
CR_R_LSAP_ERR © 
SAP _NOT_AVAILABLE 
BAD_RCV_DSAP 

BAD _RCV_SSAP 

BAD _BUFF_TRAN 
BAD _BDI_TRAN 

BAD _XMIT REQ 
BAD PDU_ SIZE 
BUFF_TOO_SMALL 
BAD_DSAP_STATE 
PDU_TOO_BIG 
QUEUE_FULL 
INV_TRANSF 
RT_LCBI_ERR 
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Bad LCBI response -- big err 
Incorrect venue value 

Data too long for data in LCB 
LLC layer event code 

DMA of a buffer failed 

Send message fail 

Bad register mail box directory 
Mail box delete fail : 

Bad receive PDU 

Mail box turn off fail 
Invalid System Management request 
Mail box turn on fail 

XID transaction error 
register mail box fail 

XID respound error 

Resolve mailbox fail 

Unknown message type 

Allocate no memory availible 
Bad 10 message 

Getbuf could not allocate 
Invalid SM return mailbox 
Genaric default error 

SM return mailbox full 

MAC return mailbox full 
Invalid DMA mailbox 

Invalid MAC mail box 

DMA return mailbox full 


- 
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BAD_LCBI_RP 
BAD VENUE 

TOO LONG DLCB 

LLC EVENT . 

DMA_BUF_FAIL 

SENDMSG_ ERR 

BAD _REG MBXDIR 

MBOX DL_ERR 

BAD_RCV_REQ 

MBOX OFF _ERR 

BAD_SM_REQ 

MBOX _ON_ERR 

XID_XMIT_ERR 

BAD REG MBOX 

XID _RSPD_ ERR 

BAD RESOLVE MBOX 

UNKN MSG 

NO _MEM_ALO 

BAD IO MSG 

NO _MEM GET 

BAD_SM_ MBOX 

DEFAULT _ERR 

SM_MBOX_FU 

MAC MBOX FU 

BAD DMA_MBOX ro 
BAD MAC MBOX ra 
DMA_MBOX_FU 


LOGICAL LINK CONTROL LAYER (IEEE 802.2, in LACS) Component Specification 


3. LOGICAL LINK LAYER INTERNAL SPECIFICATION 


3.1 OVERVIEW 


Code that implements the LLC functionality will have been 
linked with the Kernel, the System Management, and the 
Interface Software before being loaded on the LACS board. All 
required LLC processes will be activated via the actions of the 
system management process. When an adapter is to be supported, 
system management will create a LLC layer instance process 
for that adapter. The initialization code in the LLC layer 
process will in turn create the receive and transmit 
process passing a pointer to table structures for the instance. 


3.2 SUBCOMPONENT DESCRIPTION 


Each process supporting LLC layer activity for an instance, is a 
collection of procedures that will perform a_ series of steps 
required to execute the various commands supported. Requests 
For LLC actions are in the form of Kernel mailbox messages. 
Each message is a request to perform the next step in the 
sequence required by the type of request. 


Sy 

( ‘Type l1 operations will conform to two operating states, active 
and inactive. In the inactive state, the LSAP has been defined 
but will not process any messages addressed to that address. To 
transition to the active state, the LSAP must have been defined 
via a create LSAP command from system management and then 
receive an activate LSAP command from the user via a LCB. The 
circumstances under which the states change are outlined in the 
Following table. 


Type 1 Operations States 


Current Event Action Next 
State State 


INACTIVE STATE SAP ACTIVATION REQUEST REPORT STATUS ACTIVE STATE 


ACTIVE 
ACTIVE STATE RECEIVE_UL | DATA_INDICATE ACTIVE STATE 
DATA_REQUEST SEND _UI ACTIVE STATE 
; XID_REQUEST SEND XID C ACTIVE STATE 
( RECEIVE XID C SEND XID R ACTIVE STATE 
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RECEIVE XID_R | XID INDICATE ACTIVE STATE “ ~. 


TEST REQUEST SEND_TEST C ACTIVE STATE 7 
RECEIVE TEST C SEND TEST R ACTIVE_STATE 
RECEIVE TEST R TEST INDICATE ACTIVE STATE 
SAP_DEACTIVATE REPORT STATUS INACTIVE 
REQUEST SAP INACTIVE STATE 


aR GR ER OE OD OD DR OD CRP ED OED OED OD OD EP SR SO OD SD OD OD OD OD SD SD SD OD OD OF OD OD OR OD OD OD OD SD OD OD OD OD OD OD we De oO Oe oe oe ee ee oe ee ee Dee om «eo ae ow 


The terms used in the above table are defined below. 


INACTIVE STATE The LSAP is defined but will not respond to incoming 
messages. User requests will be returned with an 
inactive status indicated. with an inactive status 

indicated. 


ACTIVE STATE The LSAP is ready to process incoming messages, or 
user requests. 


SAP_ACTIVATION The activate request LCB from a user. 


REQUEST 

RECEIVE UI | An unnumbered information frame was received by the 
MAC layer and resulted in a message in the LLC layer ° 
mailbox. The message type is MAC DATA.indication. ae 


DATA_REQUEST An L_DATA.request message from a network layer or the 
megabus has been received. 


XID REQUEST -A send XID command was received from system 
management. 


RECEIVE XID C An XID command was received for this LSAP. 
RECEIVE XID _R The XID command has returned as this message type. 


TEST REQUEST A request to send a TEST message was received from 
: system management. 


RECEIVE TEST C A TEST command was received for this LSAP. 


RECEIVE TEST R A TEST command response was received from the LSAP 
addressed in the TEST request. 


SAP DEACTIVATION A request has been received from SM or the 
REQUEST user to deactivate the LSAP. 
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DATA_INDICATE 


SEND_UI 


SEND XID C 
SEND XID R 


XID INDICATE 


SEND_TEST_C 
SEND _TEST_R 


TEST_INDICATE 


REPORT_STATUS 
SAP_INACTIVE 


Generate a L_DATA.indication message from the MAC 
DATA.indicate received. 


Generate a MAC.  DATA.request message from the L 
DATA.request adding the local and remote SAP 
addresses. 


Create a XID command from the system management 
request and send it. 


When a XID command arrives from a remote LSAP, return 
the message as a XID response. 


When the XID response to a XID command returns, the 
system management message is returned as a XID 
INDICATE. 


Create a TEST command from this system management 
request and send it to the LSAP addressed. 


When a TEST command is received at this LSAP, the 
TEST response message is returned. 


The LSAP component has’ received the TEST response 
from a remote SAP. An indication of this event is 
returned to System Mgmnt. 


This is the response returned to System 
Management when requested to deactivate an LSAP. 
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3.3 LOGICAL LINK CONTROL Layer Initialization - fe 


Each instance of the code executes as three independent 
processes under the control and scheduling of the kernel. 
System Management will use the kernel procreate service call to 
initiate the LLC layer management process and pass the pointer 
to a layer instance table. There are two parts to each process, 
an initialization phase and a normal execution phase. During 
the initialization phase, each process will ‘test the step number 
in the instance table to determine which elements are to be 
initialized. Each step will save the pointer to the instance 
table passed by system management For future use. Step 0 will 
cause layer management’ related initialization steps to take 
place including the allocation of a function table for mailbox 
IDs. After the LME mailbox ID is entered ‘in the proper place, 
the table is registered with IOLD software. The step count is 
incremented to 1, and the instance table pointer is passed in a 
receive process via a create call to the kernel services. This 
time receive initialization steps are performed. The instance 
table pointer is saved, receive mailboxes created and registered 
in the function table, and the step number incremented to 3. 


The transmit process is created passing the pointer’ to the 
instance table as a parameter. Again the instance table is 
saved for the transmit process to use in future events and 
transmit related initialization takes place. Mailboxes ar © 
created and their IDs entered into the function table in th Vv 
transmit positions. 


Each process suspends execution at the end of initialization and 
waits for messages. The kernel will give the process control 
when the criteria for priority and messages waiting for the 
process have been met. 
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3.4 Normal operations 


Two parameters are present when the process iS7~ restarted, a 
pointer to the message and the mailbox ID used by the kernel to 
determine process state. This process will accept either of two 
messages From system management at the mailbox assigned when 
the process was created. The first to arrive will be a request 
to create a local LSAP. Table space will be allocated from 
PRIVATE memory large enough for the LSAP status. The pointer is 
then entered into the LSAP directory for this layer instance. 
The table will have entries for LSAP name, LSAP address, type, 
and the local MAC address to be used filled in. After setting 
the state of the LSAP to inactive, the message is returned to 
system Management with an indication of success or failure 
status. | 


The next type of messsage is the create remote LSAP. This 
message will cause the process to allocate a remote LSAP table 
from PRIVATE memory and add it to the layer's remote LSAP 
directory. The name, type, address, and remote MAC address will 
be filled in and the LSAP left in an inactive state. This 
message is also returned to system Management. 


( 3.4.1 Activate LSAPs 


er 


When the activate LSAP message is received via LCBs, the named 
local LSAP is located in the layers LSAP directory. The MAC 
associated with this LSAP is determined and a registration 
message exchanged with the MAC layer. After saving the MAC 
layer mailbox ID, placing the LSAP in the active state, the 
number of IO credits and logical address (for local and remote 
lsap, must be in the LSAP directories range) is returned in the 
LCB. The LSAP is now ready to process messages. 


A similar set of steps are performed for activate remote LSAP 
except for the registration with any MAC layer. The remote LSAP 
is now active and messages from this address will now be 
recognized. 


Until a local anda remote LSAP are both defined and placed in 
the active state, messages with these addresses will be ignored. 
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3.4.2 IOLD Messages 


\ “ 
Mrs , 
Nu 7 


This is the first step in any request. The message indicates 
that a LCB block of a given length at a L6 address is to be 
transfered across the megabus. A message with the length and L6 
address is sent to DMA services. When it returns, the next step 
will be performed. | : 


3.4.3 Connectionless Event Indication 


A test is made for the existence of the LSAP specified in the 
request. If the LSAP is present, a test is made for the active 
state. If both tests indicate that a LSAP i1s_ present and 
active, the addressed LSAP tables are scanned for 
L_DATA.indicate messages. If one or more messages are waiting, 
the LCBI is completed and a request to transfer it back to the 
L6 is made to DMA services. When there are no messages waiting, 
the LCBI will be queued on the LSAP table to await the arrival 
of a message. 


3.4.4 Read Connectionless Data 


The same tests that are made for Connectionless Event Indicatic. - 
commands in 3.4.3, are made for Read Connectionless'9 Data 
commands. If the LSAP is both present and active, the message 
walting queue is checked. If there are messages waiting, the 
buffer is transferred across the megabus to the memory address 
found in the LCB for the length specified. The LCBI is marked 
completed and returned across the megabus-~ also. When the 
message queue is empty, the LCBI is queued to await the arrival 
of a message. 
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3.4.5 Write Connectionless Data 


When a LSAP is both defined and active, as in 3.7, Write will 
cause the buffer to be transferred across the megabus. The 
Write request is changed into a _ UL_DATA.request transaction and 
sent to the LLC layer for transmission. When the confirm is 
returned, the LCBI 1s completed and returned across the megabus. 


3.5 Local Area Control Subsystem Code -- Layer Management 


Code that will create the layer SAP lists, and make or delete 
entries in those lists will reside in the LACS Code Layer 


Management. Inquiries returning the physical address or the 
logical route number as iS appropriate for the layer will also 
be supported by this code. Layer management consist of 


procedures that process the messages listed below. 


3.5.1 L TEST.request 


This request will cause the SAP component to transmit a TEST 
frame with the buffer passed as the data field. The 
command-response bit will be set to command. 


THIS FUNCTION IS NOT IMPLEMENTED AT THIS VERSION YET> IT SHOULD BE 
IMPLEMENTED AT THE NEXT VERSION, AS PLANNED. 


3452 L_TEST.indication 


TEST commands are processed at the SAP component '-= since they do 
not require a logical link to be active. If the 
command-response bit indicates that this message is a response, 
a search will be made for the TEST.request command that will be 
waiting for completion. When found, the message will be 
returned with the buffer. 


When the command-response bit is set to command, and the 
Optional information field is present, it will be returned 
without modification as a TEST response. The SAP address fields 
are exchanged, the command-response bit set to response, and the 
message queued to the transmit process. No states or modes are 
affected. 


3.5.3 XID.indication 


This request will cause LLC to issue a XID command and wait for 
the response to return from the addressed  LSAP. When it 
arrives, the XID information field will be returned in the 
indicate. 
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3.5.4 SM DATA.request 


/ 

/ 

i 

Nie 
% 


THIS FUNCTION IS NOT IMPLEMENTED AT THIS VERSION YET> IT SHOULD BE 
IMPLEMENTED AT THE NEXT VERSION, AS PLANNED. | 


34545 SM_DATA.indicate 


THIS FUNCTION IS NOT IMPLEMENTED AT THIS VERSION YET> IT SHOULD BE 
IMPLEMENTED AT THE NEXT VERSION, AS PLANNED. 


3.5.6 LM SET VALUE.request 


This message is a request to set one of the values’ in the 
parameter set being maintained for a layer. The message will 
contain a return mailbox, a parameter identifier, a parameter 
value access control information, and an empty field for return 
status. 


When the message is returned as a LM_SET_VALUE.confirm, the 
status will be set to the results of the action. Resulting 
Status may be success or failure for one of the following 
reasons:. success, fail _operation, fail parameter, fail value ~© 
fail_access control. - Access control will be allocated but nce. | 
used in this first release. 


THIS FUNCTION IS NOT IMPLEMENTED AT THIS VERSION YET> IT SHOULD BE 
IMPLEMENTED AT THE NEXT VERSION, AS PLANNED. 


3.5.7 LM GET VALUE.request 


This message is the request to read out the value of a parameter. 
The message will contain a return mailbox, a parameter 
identifier, access control_ information, a field for the 
returning parameter value, and a field for return status. The 
return message, a LM_ READ _VALUE.confirm, will contain status and 
the value requested. 


THIS FUNCTION IS NOT IMPLEMENTED AT THIS VERSION YET> IT SHOULD BE 
IMPLEMENTED AT THE NEXT VERSION, AS PLANNED. 


3.5.8 LM ACTION. request 


This message will contain a return mailbox, an 
action_identifier, an action_value, access_control_informationy > 
and a field for returning status. When the message returns as \ , 
LM_ACTION.confirm, the status and action_value will have been 
set. The actions defined thus far include the following. 


3.5.9 LM_EVENT.indicate _ 
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 & 3.7 FUTURE DEVELOPMENT AND MAINTENANCE 
we, 


Future development is expected to include the Transport and 
Network modules. Both will conform to OSI standards to insure 
compatability with other vendors in the domestic and 
international markets. The future of Honeywell product lines 
depends heavily on the adherence to these standards. These two 
layers are described in this text only to delineate the 
compatability issues. 


NEXT RELEASE IMPLEMENTATION ISSUES 
In the next release (Dec. 1986), some of the issues to implement 
in the Logical Link Control layer for the LACS communication 


software are listed as following: 


Implement generic LCBI data structure in order to coordinate 
with Network and Transport layers. 


Improve error checking algorithm, and error condition handling. 
Improve source code readibility 

Set up mail box message limitation to 16 or so. Detect the 
mailbox full situation, and status counter set up for message 
dropped. | 

Transport, Network layer interfaces. 

Aging counter set up for PDU, LCB. Or using LIFO or FIFO 
mechanism to handle queue full condition. 

(currently, FIFO mechanism for PDU, and LCB queue is 
implemented) 

System management GET function support. 


System management UPDATE function support. 


Efficiency improvement at IOLDs, Transmit, Receive processes. 


J 
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4. PROCEDURAL DESIGN _ : a, 


Design procedul is as the following: 


Ls IEEE 802 standard review and implementation algorithms 
discussion. 


2. Data structure design. 

3. PDL presudo code implementation. 

4. C code implementation. 

5. Compiling, assembling, and linking debugging. 
6. LAN software testing debugging. | 

7. Release. 


8. Support and efficience improving for the future version. 
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APPENDIX B 


The following standard BNF definitions describe the various 
system mamagement messages that can be received by the LLC 
Layer and the parameters involved. 


LAYER MANAGEMENT MESSAGE ::= MESSAGE HEADER, MESSAGE TYPE, 
MESSAGE INFORMATION 
:= Kernel message header 


MESSAGE HEADER : 
:= REQUEST | CONFIRM | EVENT 


MESSAGE TYPE : 

REQUEST :3:= Xx 

CONFIRM ::= XxX 

EVENT ::= XX 

MESSAGE INFORMATION 3::= EXCHANGE ID, LAYER INTERNAL SELECTOR, 
ACCESS CONTROL, STATUS, OPERATION CODE, 
OPERATION INFORMATION POINTER 

EXCHANGE ID ::= A 16 bit integer 

LAYER INTERNAL SELECTOR 33:= NAME, CLASS, TYPE, VENUE, STATE, 

SUBSTATE 

NAME : 8 ASCII characters 

CLASS 

TYPE : 

VENUE 

LOCAL 

IMAGE 

STATE 


il 
NmMNreot oo 


ee ee ee 


00 
Nh ui 
NO 


OCAL | IMAGE 


ANY | LOCKED | ENABLED | DISABLED | TEST |DOWN | 
SHUTDOWN | INUSE 

:= ANY | RESET | HALTED | LOADED | STARTED | OPERATIONAL 
ANY :3:= 0 


00 
TUS CODE, STATUS INFO 
= SOURCE, STATUS ID 


ee DP fies & 
i 


bit integer 
TATUS LENGTH, STATUS INFO DATA 
= 16 bit integer 


2 
STATUS LENGTH 
D = Xx 


STATUS INFO 
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LOGICAL LINK CONTROL LAYER (IEEE 802.2, in LACS) Component Specification 
OPERATION CODE : LM_GET VALUE | LM_ SET VALUE | LM_ACTION 
LM_ GET VALUE ::= 
LM_ SET _VALUE = 
LM _ ACTION s:= 4 


1 
2 


LM GET VALUE STATUS ID ::= STD STATUS 

LM SET VALUE STATUS ID ::= STD STATUS | BAD PARAMETER VALUE 

LM ACTION STATUS ID ::= STD STATUS | BAD STATE | BAD SUBSTATE | 
ILLEGAL STATE CHANGE 


STD STATUS ::= SUCCESS | NOT SUPPORTED | BAD ACTION OPERATOR | BAD 
LAYER INTERNAL SELECTOR 

SUCCESS ::= 00 

NOT SUPPORTED ::= xx 

BAD ACTION OPERATOR 3::= xXx 

BAD LAYER INTERNAL SELECTOR ::= xx 

BAD PARAMETER VALUE ::= xx 

BAD SUBSTATE ::= xx 

ILLEGAL STATE CHANGE ::= xx 

BAD LAYER INTERNAL SELECTOR ::= xx 

OPERATION INFORMATION ::= LM_GET_VALUE OP INFO | LM SET VALUE OP INFO| 
LM ACTION OP INFO 


LM_GET VALUE OP [NFO ::= PARAMETER ID, CONFIRM INFORMATION POINTER 
LM_SET VALUE OP INFO ::= PARAMETER ID, PARAMETER VALUE 
LM ACTION OP INFO ::= ACTION OPERATION, STATE | SUBSTATE 


PARAMETER ID ::= xx 

CONFIRM INFORMATION POINTER ::= values | list of values 

PARAMETER VALUE POINTER ::= pointer to new value 

ACTION OPERATION ::= UPDATE STATE | CREATE | DELETE {| LIST | TEST ACT 
UPDATE STATE ::= xx 

CREATE 3::= XxX oo 
DELETE <::= XxX a. 
LIST ::= xx 
TEST ACT ::= xx 
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APPENDIX B 


THE PROCEDURAL DESIGN LANGUAGE LISTING OF 


LOGICAL LINK CONTROL LAYER 


Table of Contents 


lic_lme 
Lie init 
lle rev 
llc xmit 
lle const 
lle .struct 
licincludes 
lic_mac 
lic_trans 
lic _mega 
lic_dbg 
llc_stubs 
lic common 
llc _event 
llc_err 
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LM HK MRK KR EK KER REE EEK KR KK KEKE KEK KEKE KEKE KEK EKE 

WWE KECK HR KK KKK KEKE RK KK RE RKKRK KKK KR KE KKK KEKEKE RE KRKREKKKKRKKEKKEKKEKX 

RX «* 

cre 

kk 

net | | HONEYWELL 

kee 

nk | Local Area Network 

ke | 
"x % L 3 t L IN K CON TR 
RK 

kk iL 4 Y = R 

> a ae 

ie | Layer Management module 
wR ® 

te & & 

ket Copyright: Honeywell information Systen 
kee ALL rights reserveac. 

ke 

exw Cereate Date: 1/25/35 

fk woe 3y: De ISNaughnn 

tek & Jiscription: 

RK 

ke * Revision &: 1 a 
nk k date: 53/25/34 is ast 
wk 3y:. Me Lu 

kk Discrintion: 

rnwe 

we & © Qevisiaon 4: 

k* & Dates 

wee 3ys 

kK Discriptions: 

xe Kk 


€> 
r 


+4 
oO 
> 


w&e& 
rk 


eke Functions & Parameters: 


»% 


ile_tme Cmoxptresndx_name) 
MSG *mDxptfe 
M3ID moOx_names 
Lm2a_teo tmoxptrelica_p) 
MSG «mbxetre * Pointer to Lce message * 
LICA xlica_p- * Pointer to (Ile Layer inst. taole * 
sm_req(moxotrerlica_p) | 
MSG *moxptrs * Pointer to Lie Layer inst. tabdle * 
LICA *xlica_ps * Pointer to Lke Layer inst. taole * 
Mu_reg_ak(moxptrelica_p) 
MSG *mbxptre 
LICA *lLica_ps * Pointer to the precess variasles * 
rej _normal(mbxotr/lica_o) y 
MSG *mbxptres Ny 
LICA *lica_ps * Pointer to the process variables * 
im isettCmoxotr-lLica_9) 


* © heh RHR eH RHR HH 
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& “3G *xmoOxptrs 

x LifA wxlica_ps * Pointer to tne eorecess variaalas * 
x im_cnor_n_set(mbxotr-lica_3s) 

x M35 *noxotre 

« LICA «lica_pr * Pointer tc tne process v3ariaoles * 
* LmigetCarxotrelica_a) 

& MSG *mbxotrs 

ad LICA xlica_pse * Pointer to tne process viriables *. 
* Lm_action(moxptre,lica_9o) 

* MSG *moxptr,s 

« LICA wlica_pv * Pointer to tne orocess variaoles * 
« ageing_alarm(mcexptrelica_p) 

® MSG *mOxptr, 

* LICA *lica_pe * Pointer to the process variaales *:; 
fe search_r_sao(remote_addrer_dir_taolesdir_indexslica_9o) 
* char *remote_addrs * adaress of the remote LSAP to search * 

® R_ LSAP_DIR *er_dir_tacples * Pointer to a remot2 LSAP airectory table * 

% ushort rxoair_index, * Pointer to index into remote SA? directory * 
* LICA xlica_ods * Pointer to tne Layer instance tadle * 

® srch_name(lsap_name-vlsap_dirsdir_sz-dir_indexviica_p) 

se cnar xlsap_nane-z x Pointer to the LSAP name for search ®* 

ve QR LSAP_DIR xlsa@o_dirs * Pointer to a LSAP directory table * 

& ushort csir_szs * Size of SAP directory * 

x ushort *air_index, * Potntar to index tnto SAP directory * 

4 LICA *«lica_p- * Pointer to the Layer instance taale * 

( next _sap(r_air_tablesdir_sizesair_index) 

= R_LSAP_DIR *«r_dir_tabdles * Pointer to a remote LSAP directory table * 

* ushort dir_size-s *« Size of cirectory seing searchec x 

* ushort xdir_incexs * Pointer to index Into remote SAP directory « 


KHMER KK RRR REE RK K KEKE EER KKEKKEKKERREKEKKEKKKKE 
‘SERRE SRA RSEEAR ES ARASLE RAS RERERRSERERASASERASSSAS SRS RERELRS SRE SAS AS SS ES 


xf 


ie mbt eet eEERRLESESESEREBRERERERALAZSESRSELASERERSESRE SS AES SASS SSL ESSA SEALS SC SE 


The following conventional *C* code header file is used 
Dy this process. See tne respective files for sefinitions, 
Structures and macros. 


® 

wR eee escccnescccccssnallC Layer Nanazsementascccesecvescscceees 
*« This is the LLC Layer management that exist once for each 

we tLe Layer instance created. The comeEination of this arocesss 
x the recieve process and the transmit precess constituteas one 
* LLC Layer instance. 

« 

” TITLES? : LLC LAYER MANAGEMENT INITIALIZATION FUNCTION 
te FUNCTION: T3s 

ad INPUT: 

* QYUTPUT: 

w 

« 

xX 

& 


rece SRA EEO REARS OSOSRRSaRSSSESRSRSSRALRESESAASBARARDABRSOERERSARAAAAARARASRAASALEABRARARSA ASA & | 


x f 
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LHRH RIK KK KR KK RR KK KERR KKK RRR EEK KKK KA KKKEKKKK KEKE KK KKK 


fx 


* 


TITLE: weLC LAYER MANAGEMENT FUNCTION 


FUNCTION: Receives all messaye sirected to LLC LY mbox. It 
then determines the correct orocedure to call 
to service tne message. 


INPUT: Pointer to messaje 
Mailoox name 


OUTPUT: 


bee a: wiete. Ae a wle ween we ee ae Layer Management ecaaccacscasneccseevaseaces 
This code is the cperational Layer management for each LLC layer 
Instance. Mailbox messages received will oa asecoded by the switch 
Statement into a procedure call for each case Listed below. The 
pointer to the messaye and tne pointer to the LICA table will de 

* Jassea on to each procedure as parameters. 

ieee DEEP SARE RSSPARABRSRESRSESAAESASZALRALE SLE AEE ERS SELLERS SERRE RSERAEERERSAS | 


«f 


+ A + © Hh RRR HH eH HR HR RH 


/*x pointer to the LICA tadle */ 
/x Retrieve tha Layer Instance Common Area pointer x/ 
f/x 309 CASE on message type */ 
f/x CASE An IOLD request message */ 


/* Increas2 counter x/ 
Jx Call common orocecure to hanacle the IDLD request *«/ 


/x CASE The confirm to DMA a LC3SI to tne LACS has returned */ 


/x increases counter */ 
f/x Call the orocedure which processes the LOSI */ 


f/x CASE The confirm to DMA a LCBI to the LS Aas returned x/ 


f/x increase? counter *x/ 
fx Call the orocedure which will clean up after comoletion of L¢3I x/ 


f/x CASE SM request message Aas deen received */ 
fe Call the orocedure which orocesses syst2m management requests */ 
4* CASE I0 S13sp. and DMA mailsox tid resvonse neassage returned «/ 


4x Call orocedur?® to store mbx ids and 
initiate FC mox dir. recistr. */ 


; ~ 


a ™ 
: 
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/*® case serve to transoort Layer activate reguesrt */ 
f/x call transport interface activate srosedure +/ 


fx CASE FL NOK SIF. P25Istraticn resognse mes3saye nas cteturned «/ 


f/x Call crocecure to clearuc after razistriticon rescsns2 returns */ 


wm 


Je SASE 4AC activate messa3e returned form ¥YAC Layer mar */ 


/* case C4Y_REG_RQ + CNFERY 4OS): w/ 


/e Call oracedure to cleanup after activation response returned «/ 


f/x CYHERWISE */ | 
IPARSEREESESESESSESRESZESEALESASSS SSE LSC ESESESESE ELSES SSS SEL ELE LESS ES Ses 
f/x Tne message can not oe decoded into any that are axpected cy this 
* process. 

At tnis stages 

tne space us2d by the message 18 returnes to tne kernel 

until 3a nethod is designed to nandle the proolem. 


a eH 


* Also alarm messages should be aaced 
Oe SERRaSEALESESERARSLERAASASAS RAS AASESAEBASRAARRERASASLA EES SRERAA SAAS SE © 3 


« / 


{ |x mfree(moxntrds */ 
as f/x return to the calling */ 
Je if ERR_LRETURN */ 


f/x ENDCASE End of the messase type decoding */ 
/e switcn */ 


/e Lle_lme x«/ 


/* Pointer to Lco message «if 
/x Potnter to Lle Layer inst. taole */ 
/x error status */ 
/* Pointer to tne transaction black */ 


f/x A casting stes */ 


/* DO CASE on function soecific function code in the LCSI «/ 
/* CASE An event oraer */ 
/x CASE The activate LSAP order x«/ 
/*x deactivate case */ 
f/x CTHERwWISE Cinvalic order for this channel) */ 
f/x Set completion wora in the LCAl : xf 


LRH KKK EHR KKRRERKEKKEREKEKRKEKEKKKKKRKEKKE KKK KK KKK / 


f/x Request DMA services to transfer LES wf 

7 /* This 1S one of tne difficult errors to hansle */ 

Cc LVR HK KKK KREME KKK EEK RREKEKEKKKKKEKRKEKEKRKKKKKK / 
ue 


fe Ff ERV RETURN *#/ 


S 
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/* rpaturn to tne calling */ 
fe Gf chA_VETUIN */ 


{/* Resort the oresence2e of an invalic function c2ae 


/* ENOCASE </ 
Je switcn */ 
f/x tle -lme_leo */ 


«/ 


LK EH KKK RK KK KKK KEKE KK EKER KKK KKK EKER KEKE ERE KKK EK KEK KK KKKK KK f 


/ 


*% 


* nha HeH aH HH 


® 


® 


TIVES SM REQucsT FUR LLCO LA FUNCTION 


FUNCTION: Receives a SM request message and determines 
whether it is a valid request. Tne meesase 1s then 
forwarded to the function which can aexecute the 


request. 


INPUT: Pointer to mailoox message 
Pointer to layer instance taole 


QUTPUT: 


(2a eee ee RERAARAASS SS RAR RAAELRARS RS RSA RASRASSASARASZARARSEER SE RAR ARASSASASE ALAS Se 


sd 


/ 


{x Pointer to Lle layer. inst. tasle */ 
f/x Pointer to ile Layer inst. table */ 


f/« Pointer to the SW request */ 
/* error coda «/ 


/xe A Casting step */ 
f/x DO CASE ON Operation code in the reguest */ 
fe CASE A GET request */ 


/e CASE A SET request *«/ 
case ST: 


Je TASE A Compare ang Set request */ 
/x CASE An ACTION raquest */ 


Cinvalid request) «*/ 


f/x OTHERWISE 
fe if EQQ_RETURN e/ 


f* eENDCASE x/ 
/* switch */ 
f/x Set messag? tyne to indicate a 3M Confirm message 


f/x Send the resoaonse message to S$” «if 


wf 
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fe return to tne calling */ 
fe FF FRA_LKETURN *#/ 


/~e rpaturn to tre calling *x/ 


fe FF FRALRETURN *#/ 
fe rpaturn te tne calting */ 
fe Ff TF2A_RETYURN */ 


f/x (le_sme_regq x/ 


IRA RERPESAEERESESEEOSESEASRIRCASESASSSSSRCSESRESAESESSESAEESE SSL ESSOCAS ESE 
/« The proceaures in tnis section supsort tne Layer managenent functions 
* for the LLC Layer. 


* Thea MAS signrin messag2 has returned 
(2 cee RRR ESRSaRASERBAERSBSBSASRABRERSEZEaRERSAAARRSaRERSBSBSAASABRSORASARASZARALSAASASASA ESE S&S | 
x f 
/* Pointer to the process variacles */ 
{x Thts message 1S returning from the MAC signrin orocesse */ 
/« Pointer to tne returning query message */ 


( {/* Save the mailoox ID to send MAC_DATA. request messages */ 


/x Release the massage block to free memory again «/ 
f/x mu_req_iak */ | 


[e222 ESPRRLRSASSRLERSEASRE SEES ESE SELERER ESLER ALE RESES ES EEE LSE REEL SERS SL ERLE LES EE 


/x Tne IOLD signrtn message nas returned */ 
LEW KK RRR KERR RE KEKKEKRE KKK KREKKKR EK KEK EKEKREKKKKKE KKK KERR KEKK KKK KEK KEK KEK Kf 


f/x Pointer to the process variacles */ 


LIK KK REE EKKEKKKREKKRKE KK KKKKAKRKEKKERKKKKKRK KEKE 


/* This message has oaen returned fron [OLD sign-in and 15 counted 
* 35 sart of the transition to the ‘ready state* for the instance. 


* Each message received increments the count oy one. 
ieee SRERERERSZESSEL£&SSA RASS EAASZARAASPLARSASASERASLASASLASLAA SARA SAS SRAR AAAS @ 


« f 
/* IF the registration was a success */ 


f/x Record th2 return of one of tne REG_NORMAL messages */ 
fw ENDIF */ 


/* LLO LME Intitialization complete af 


/* NEED TO FIND SUT IF EVENT SHOULD 3€ ISSUED HERE OR IS IT OPTIONAL &/ 


f/x Release the message olock to free memory *«/ 
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[KK KR RR E KKK KK EEE RE RIE RREREKRER KEKE KKKKERKREKK KKK KKK KR / 


/« 


f/x reg _normal */ 


fe LM SET~regquest */ 


Tom RR RRR KKK ERR ERK RK RE KEKE KEE RK KEE KKEKEKKKKKEKKEK KKK EK / 


/* Pointer to the process variacles */ 


FASE UPSEERSESALCESAESCESASSALESSESSESESRE SEES ESE SASLESAESES ASSESSES S SLES S, 
f/x 09 CASE ON parameter_identifie2r */ 

/*® CASc each valia parameter x*/ 

fe IF tha access_control_information is correct then */ 


LEHI KKK KK KKK KEKE KKK KREKKKKKKKKKK KKK KKEKKKKKKEKKKKE | 


/x IF this parameter may se altered then */ 
/x IF the new parameter is in range for this item */ 


f/x set the parameter to thea new value */ 
f/x salact success status *«/ 
f/x ELSE «f/f 
f/x solect fail_value status «*/ 
fx ENOIF x/ 
f/x 2LSe *«/ 
/~ select fail_operation status */ 
fe ENDIF kf 
f/* ELSE, wf 
‘x seiect fail_access_control status */ 
fe ENDIF ef 
{x CTHORWISE w/ - 
/x select fatl_parametar status +«/ 
fe =ENDCASE *e/ 


/* return a LM_LSET VALUE. confirmation message with selected status 


/x tmiset */ 


*f 


ef 


LRM KR RK ERIK RK KK ERK KR EKA KKKRKKKKKEKKKKRARKEKAEKKREK KKK KK KKK / 


/* 


Je LM_COMPARE_AND_SET.erequast */ 
FARSEPCESESBRESAEESESESLE ESSERE SEE ESSES SER CRES ASE S CSP SE SESE SES LES LE LE SESE LES eS SS 


f/*« Pointer to the oracess variables *«/ 


/* 093 CASE on parameter_identifier *«/ 
/x CASE each valiac parameter */ 
f/x IF the access_control_information is corract than */ 
/x TF this parameter may be altered then) */ 
/e IF the new parameter is in range for this item */ 
f/x ITF the exnected_parameter_value is correct then 
/*x set the new parameter value */ 
/« select success status */ 
f* ELSE ve/ 
/e select fail_expexted_value status */ 
fx ENDIF */ 
/« =2=LSE xf 
4x selact fail_value status */ 


*/ 


Seen St ee ee ee Lie ayer Manatenent. == 1s See es sses ss os === 


xf 
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om 


f/x ENDIF xf 
f/x ELSE xf 
/* select fail_seeration status */ 
f/x ENDIF «ef 
f/x =LSE xf 
f/x select fatl_access_controi status *«/ 
/* ENDIF x/ 
fe CTHERWIS2 */ 
f/x select fail_parameter status */ 
f/x ENDCASE */ 
f/x tm_emor_n_set */ 


LW RK KKK KKK KK RE EEEKKEEKRARKK KEKE KK KEKKEKKKKRKKEKKRKKKKK KK KEK KKK KK EK / 


/e LY SET.~request messag2 *f/ 
LEH RIK KK IK KKH KKK RRR KR ER ERK KKKKEKKKKKKEKRKKKKKKEK EK / 


/e Pointer to the orocass variasoles */ 


/*® DO CASE on parameter_identifier */ 
/x CASE any valid dvarameter x/ 
f/x IF access_control_iatornation is correct */ 
f/x TF paraneter 1s readaole */- 
| /* read the oarameter value */ 
ae f/x select success status */ 
( /* ELse «f 
f/x select fairl operation status */ 
/* ae wf 
fe ELS x | 
| eta fatl_ access_ control status */ 
fe SNOLTF *f/ 
/*e OTHERWISE */ | 
f/x seiect fail_sarameter status */ 
Jx ENDCASS xf 
f/x return LM_SETeconfirnation witn selected status */ 
/x (nm get x / 


MESURE EEEERERESESESESPESESPESSARLSESESASSEESER SESSA EESAESELE RSS SSS REESE LC ELSES ESE EE LS 


/x* L¥_veéTerequest messayg2a */ 
IEP SEEESERESESESEORERSESESLESILASLALS EASE SSELESESEASSESESESELSSE SESE LE SL ASSETS i 


{/x Pointer to the orocess variaples */ 


/* DO CASE on oarameter_identifier x«*/ 
/* CASE any validjd parameter xf 
/x* IF access_control_information ts correct */ 
Bi IF Sarameter is readable */ 
f/x pead the parameter value */ 
f/x salect success status */ 
fe ELSE ¥*/ 
/x select fail_operaticon status x/ 
fx ENDIF « / 
fx ELSE «/ 
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XL. 
/* select fail_access_controal status */ 
fx ENDIF xf : 
Je OCTHERWIS= x / 
f/x select fail_nsaramneter status */ 
/x ENDCASE */ 
fe raturn LM_OELeconfirmation with salected status */ 
/* imiael «/ 
LREKRKERERKKRKEKKKKKAKKRKKRKKKKKREKKEKKKEK RRR EREKERKKKKKEKEKEKKKEKKRKKK KK EKK EK / 
i aaa Sea oes: fC Layer Manace Tent. -e--=<-e----- ea eee ee Se x | 
3 
* bie ape ee SCTION REQUEST PROCEDURE 
® 
« FUNCTION: Setermines whether it 18 a valid action reguest 
* and routes the raquest to the orocedure requirec 
® to perform the operation. 
& 
* INPUT:  PoInter to mnessajge 
* Pointer to LLC common sata table 
* 
* OUTPUTS: 
« f 
T Bie Be ato Sa hee Ge ws a eae ee Layer MANAGENENteccnccacccccccsecansacccasktl 
f/* LALACTION. request m2ssaje */ 
fee Keexkrekkkekkeek eRe KKK KRAEKRKEKEKREKEKEKKEKREKKKEKKEKKKREKRKEKKK KK KKK | wets 
/x Pointer to the orocess variaoles */ Ne 
/* SHOULD LLCERR code 3& INITIALIZED 27727 ay, 
f/x Cast action request onto the message xf 
fe DQ CASE on action_identifier */ 
fx CASE of a LIST ALL recuest : «/ 
/* IF request is to List all ramot2 LSAP « / 
/*x THEN a] 
f/x Call tList all remote LSAP procedure * f 
fe ELSE if request is to List all Local LSAP « / 
4x Call List all local LSA? orocedure « f 
fe CTHERWISE it must Sse a error x / 
f/x ENOIF «f/f 
/* CASE of a UPDATE STATE request «xf 
f/x Call update LSAP state routine | x f 
oreakes 
/x CASE of a CREATE LSAP regquest af 
case CRceATE: 
/* If request 1s for a remote LSAP creation *f oe 
/*x THEN os —_ 
/x Call create remote LSAP procedure * f Noa 


f/x ELSEIF reguest is to create a Local LSAP : «] 
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Je Call create Local L3A? oroscagdure xf 
Je OTHERWISE 1t must 56° a error xf 
f/x cNOTF | « f 
/=x CASE of a DELETE LSAP resuest x / 
Je DEFAULT an unsudoorted action iaentifier xf 
/x Cast action respons? on messaje */ 


/* Set status to indicate an unsupcortes action tdentifier x/ 


Je ENDCASE */ 
/e switcn / 
> /« Lme_action x*/ 


tay 4 


J ee REE KKK KK KKK KK KKK RK KKK KKK KKK KKKKK RAR KEKE KKK / 
{x << 2 a a a aa an a ae ae a <> D> ae a ED ae a ee LLC Layer Manayjement On a eo a a eb a oe ae ee ee ee —_ xf 
f/* M2ssage aginsc alarm message x/ 

RESUS ESESESESERESESASESCESESESESSESAESASCESESESALESASESSS RS SESLE LESSEE RESELL ASS wy 


LMM KHMER KKK RR K KEKE KEKE EKEEKKKEKKKKRKKKEKKEKKKKEKKKRKKKEKK / 
f/x This message is the returning alarm request from setalarm. ALL Liodu 
emessages attached to all LSAPS will be aged one time increment. Any message 
*« found to oe over tne age Limit will de released dack to tne suffer pool. 
*« The assumption is that overaged messaces are unexpected and 3 LC3 will 

ge © Never oe issued. 

( SESS SRSESCSISSLAESSES LASSE LCRSESSLASS ROSE ESLESSSE ESR LAESC ASSES ESSEC SAS SES ST SSE LES: 


f/x IF this instanc2 is In the reacy stata then */ 
/* FOR each IEEER9D2 definad LSAP that can exist */ 
f/x Point to tha LSAP tadsle x/ 


/* IF tne LSAP has been defined */ 
/* 0C for eacn nessage on the waiting~for"LCS queue */ 
/e Increment the aging counter */ 


/* IF the aging counter ts STE the Limit */ 
/* Renove the message from the queue */ 


/x Release the suffer sosace to the aoal */ 
f/x update the queue countar *x/ 


/« Release the memory to the menory pool */ 


f/x Notify SM of the event */ 
Je ENDIF «/ | 
fx Roll thru the queue to the next entry */ 
f/x ENOOO x/ 
fe ENDIF «/ 
fx ENDFOR x/ 
~ ¢® ENDIF «/ 


f/x Request tne next aging alarm period */ 
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a ‘ 
LHRH I KKK KKK ERK EKER EKEKEKKEKKER KKK KK KKEKKKKK KR KRKKKEKK KKK / aus 
fe. PRs eres sere ase ee see errn = Lhe beyer Manage nent. = ==-="== See «f/f 
/* 
* ViETLe: SEARCH REMOTE LSAP ADDAESS PRTCEDURE 
® FUNCTION: TA¥s orocegurs s2arcnies thea ramote LSAP girectory 
* 7 from a supplied acscress for a matcn tec a given 
* acdress. It returns pointer to a value containing 
& an index into the remote LSAP directory tanle 1f it 
* 1s already adefineds otherwis2? it will return 
ad a negative error value .« 
® 
* INPUT? Remote L3AP Acdress 
® Pointer to remcta LSAP taole directory 
* Pointer to directory index value 
% 
© QUTPUT: 
e Error status 
x , 
(ieee eke eee ea EDE Ee RRASRASASRASSAO SR RASA ERS RARARSERABRARELE SASS SASL AAA SS Oe ee 1 
wf 
/* 
kekeeew NESD TD REVISIT THIS IN ORDER TO SUPFGRT xreexnee 
kewekewee 29 GENERIC LAYER FUNCTION Riek kk ee aa 
x / : N JZ 
/x Initialize flagsvsindexess and counts nf 
f/x DO WHILE the remote airectory tndex value is less than or egual toa 
max number of entries in the directory § */ 
/« TF the directory index points to 3a valia entry (non null entry) «/ 
f*« TdEN & f 
/x Fetch the pointer to the addrass in the remote LSAP taole */ 
f/x Set the status flag to indicate 
a match tnitially (null value) wf 
/* Initialize count to zero x f 
f/x Compare the two acdresseas an octet(ayte) at atime to deternine 
if there is a match x / 
f/* DO WHILE the numoer of address octets checked 
is less or equal to 7 xxx Lue 
ana the address octets match */ 
/x If the given address octet 1s 
equal to the address octet in the remote 
LSAP table x f 
/* THEN «/ 
ue 
/=x« Increment the pointer to the adaress | i. 


octet in the remote LSAP teaole «/ 
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ment the nunoer of octets crecked *«/ 


re 
e tnere 13s no asdress match « / 
Sec status flag ta indicat? 4a no natch x/ 


/* Incremant tha airectory index value xf 
f/x enDIF */ 
fe =NDD2 */ 


f/x ELSE atrectory entry ts not valid (null) *«/ 
fx Set status flag to insicate ano match */ 
f/x Incrament the directory insex value ® / 
f/x ENDIF «#/ 
f/x Set status flag to raflect match flag status xf 


fe eNDDD */ 
fe RETURN */ 


[KKH RRR RE RR ERR ERE KEE REKRKKEREK EERE KKK KEK RE KK RK] 
[* 
pe Og & SEARCH LSAP NAME PROTEDURE 


FUNCTIONS: This procedure searches a Local or remote LSAP directory 
for a match to a giv2n name. If a mateh is found - 
It returns pointer to a value containing 
an inaex into the LSAP cirectory table . 
Otherwise it will return a negative error value . 


INPUT: Pointer to LSAP Name 
Pointer to LSA taol2 airectory 
Size of LSAP directory 
Pointer to directory tincex value 
Pointer to Layer instance table 


OUTPUT: 
error status 


a ee ee ee ee | x + ¢ Alm * 
Ke 


WHR MME RRR K RK RK HMR EK RRR REE EEK KEKKREKKREKREKRKERKREKEKEKEKKKEKEKKEKKKKKK 


/ 


/* 
wkkekkee NEED TO REVISIT THIS IN ORDER TO SUPPORT xxxunxx 
kekeekeer 9g GENERIC LAYER FUNCTION Rk kk tk 
kekkkee ALSO make presentadle kkk kan 
xf 
fx Initialize flagsvinaexess and counts. xf 


( f/x 09 WHILE the remote directory index value 1s less than or equal to 
= max number of entries in the directory */ 
f/x IF the directory index points to a valid entry (non null entry) */ 
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fe THEN w/ 
/«* Fetcn the pointer to the nane in tha L3A? tasle xf 


/e Comoare tne two addresses an octet(syre) at a time to determine 
if there 18 4a matcn x / 


4/* Set tne match flaz to incicate 4 
matcn tnitially (null value) wf 


/* Initialize count to zero xf 


/* 00 wHILe the nunber of scairass octets cneck2da is 
Less or aqual tc 16 
and th? acer2ss octets match « f 
fe If the given name octet is eaual to 
the name cctet In the remote 
| WSAP table | af 
/*® THEN */ 
f/x Incramant the sointer to tne 
name in thea remote LSA? taole */ 
f/« Increment the numder of octets checked xf 
fe =LS5Se€ there 18 no address match ¥/ | 
f/x Set status flag to indicate a no matecn */ 
/* Increnent the directory t1ndex value */ 
fe ENDIF */ 
f/x ENDIO */ 
fx =LSE directory entry 1 ror valia (null) x f 
Je Sot match flag to indicat? a no match */ 


f/x Increment tne Girectory itnc2x value «/ 


fx ENDIF xf . 
/x Set the status flag to reflect the conpare operation *« 
f/x ENDDO | «f 
fw RETURN ¥/ 
r /* srecn_inane */ 


LR RRR RI KH RRR RK REE KE WREAK KERAEKEK EKER EEKRKE HE EKKRKKRKEKKAKAKKKRK KKK KK] 
/ x 


x 


Titties | SEARCH FOR NEXT AVAILABLE DIRECTORY ENTRY PRICEDURE 


FUNCTION: This procedure searches the remote LSAP directory 
from a supplied aadress for a null entry 
address. It returns pointer to a value containing 
an index into the remote LSAP directory tadle if it 
is alreagy aefineds otherwise it will return 
aonegative error value . 


INPUT: Pointer to LSA? taole directory 
LSAP table airectory size 
Pointer to directory incex value 


QUTPUT=: 
Error status 


* ee hetRKeRA HR eH RR RRR 
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Kew KK KR TKK EK RR ERK KK KEK RAKRKE KEKE EK 


x f 


Jj 

waeweeee NEED TI VEVISTIT THES IN CROZR TD SUPPORT wKrexane 

keke oa GENEVIC LYAEQ FUNCTIAN keke KER 

x / 
{f/x Initialize flagssiniexess and counts xf 


f/x 30 FOR the remote cirectory incex value is less than or equal to 
max number of antries in tne directory 
AND the directory entry is null «f 


f/x Increment the directory index x«/ 

f* ENDDO x/ 
f/* IF the directory index points ta an availaole entry Cnull entry) */ 
fx THEN wf 

/x Set tne status flag te insicate a success (nuil value) x f 

fx ELSE there is no address natch */ 

/x Set status flag to indicate a no availoala antry «/ 

/x ENOLF */ 
fe RETURN */ 
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LH RK WK KE KK ERE KR KKK RK KKK ERK RK KK EKER EK KEEKE KKK KK & 

RHEE EMRE KR KR KERR KKK RHR EKER ERK RK KK RREKRER EKER RK KERR KK 

wRKe* 

xn * 

eK « 

wee HONZYWELL 

Rw , 

Kaw wOocal Area Network 

ee 

Kee L_¢ecc6ggfereeatke L IN « CIN TROL 

wR 

kt 1 «a Y & R 

eK 

eR Layer initialization module 

ket 

kK 

kk « Copyrignt: Honeywell Information System 

w* te ALL rights reservad. 

eK 

ak k Cereate Date: 3/25/35 

tk sys Me Lu 

wke Discriotion:s 

xen K : 

wee Functions » Parameters: ow 

le te te : —— 
Ne 

x 

we LLe_tme_init Cstartuo_oaram) 

x STARTUP_PARAM x*startud_daram, *« Potnter to startup parameter Slock * 

« Llkce_req_to_analreturn_mboxslica_p) 

* M3Il0 return_moo0xs 

* LICA elica_p,s 

* rev_mox_ids(mbxptr-lica_o) 

ss MSG *embxotr, 

x LICA *x«lica_ds * PoInter to the process variaoles *. 

* reg_fembx_ air €lica_a) 

® LICA xlica_ps * Pointer to Layer Instance tasle * 

® create _l_lsapCmoxotr-lica_o) 

® MSG *mDxptre *® Pointer to create Local LSA? message * 

* LICA *lica_oz * Pointer to the tntarce taole * 

* create _r_lsap (mbxstrv-lica_p) 

* MSG *mDxptre * Pointer to create Local LSAP message * 

* LICA elica_ps * Pointer to tne instance taole * 

* 

ekx 

we & Revision 4: 

ke & Date: 

xk* ay: 

kkk Discriotion: 

kk* 

% tt Revision #3: 7 pes 

kek Dates aa 

ke & 3y: mae 


7% Discription: 
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x* x 
kk 
WHERE MRR KR KKK KKK RK RRR EK RE RK KEE KK KKK KEKE KER KEKE KK REE KE KK KEEK 
KREME KH RH RRM HR RK KH RR KK ERE KERR ERE KCK EK REE KEK KER HE KEK KKKKKKE REE RK 


« / 


if me Peete eeeeSeSeeeERSASESERERERSLESAELESESERERS RSS AERP SE ASE RE RSE SERA E SE SEE SS 


600-60 eeew eweweeeee cbt Layer Mana Je tent a «660 w GS e0.o Wei Se S86 ee 
This is the LLC Layer managemant that exist once for each 
iiLc Layer instance created. The cambination of tris sroceasss 
the recieve orocess and the transmit process constitutas cne 

LLC wayer instance. 


td 

® 

sd 

® 

« 

® 

® H 

* Pires LLO LAYER MANAGEMENT INITIALIZATION FUNCTION 
* FUNCTIONS TBS 
J INPUT: 
x IUTPUT: 
& 

x 

* 

® 

® 

x 


The foilowing conventional 'C' code header file is used 
9y this orocessSe See the ressective files for sefinitionss 
structures and macrose 7 


Ae S2REaRERSRERSBSARASSSAERSORSRERSREALSRARS RASS SARL RS SRARSLASSRSERERAS SERS SSR ASASE SS | 
a 


© vccsienceussassciussunedivanvatechicneevashesacenceactectuncnasanees’ 
* This ts the initial entry point for The process. The 
* code 1s executed once as an initialization steo. ALL other 


x entries are at Lle_tme. 
HHH HK KKK HK HH KH HH HK HK RRR KK RE KK KKK KE KKEKRKKKKRKRKEKKRKKSK 


xf 
f/x Pointer to startup parameter astlock */ 


fx jind®x variaole for array initialization */ 
fe clear olock stze */ 
f/x Priority of receive orocess «/ 
/*« Priority of transmit srocess wf 
/x Pointer to the Layer instance common are3 e/ 
fe Pointer to this layer instance receive process name */ 
f/x Pointer to this layer instance xmit process name */ 
/* Return code from kernel calls */ 
/* Pointer to IOLD stgnin messasce *«/ 
/*® Pointer to the recetva process PC3 */ 
/x Pointer to the transmit process PCB ef 


/* How do you make this a variasle xf 
f/x Start of LLC Layer management initializatian & f 
C /* Allocate space for the LLC Layer Instance Common Area taole */ 


““f{*® memory alocation error handl */ 
f/x raturn to tne calling */ 
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[«* 


/* 
/« 


[* 
{x 


|r 
/x 


Wi 


/e FF ERX RETURN *#/ 
record tne Lica at reserves tanta / 
iAtitialize all of Layer instance taal? ¢9 NuLL «if 
set Layer instance tasle neinter */ 
f/x Clear if all x f 
Save the pointer toe tne Lica tacle for this process */ 
Allocate space for the LLO local LSAP girectory tanle *«/ 
f/x memory alocation error nandl x/ 
f/x return to the calling */ 
Je Gf ERR_LRETURN *#/ 


/*x racord tha L_lsan_air psinter at reserved table */ 


Initializa all local Llsan entries to NULL xf 
Allocate space for the LLO remote LSA? directory tasle +«/ 


{x memory alocation error fhandl */ 
f/x return to tne calling *«/ 
Je FF ERRLRETURN */ 

/* recora the r_lsap_cir pointer at reserves taole */ 
Initialize all remote tsad antries to NULL . xf 
Allocate soace for the iLe emergency nessage to SS */ 

f/x memory alocation error nanal *«/ 
f/x return to the calling *«/ 
fe 4¢ ERR_RETURN */ 
initializ? all LLC emergency message entries toa NuLL «/ 
/« Clear it all « / 
Creat2 a second mailbox for LLC LME x/ 


Add LLC Layer Managemant mailoox ID to the function coce directory r/ 
THIS IS A TEMPORARY PIECE FOR DEEUG wf 


Resolve mailbox for Controlier L¥Z and Store in layer instance tanie */ 


f/x return to the calling */ 
fe Ff ERR_RETURN *#/ 


Set tayer to equal LLC Caper =c) of 
Save the instance numder oassed by SM x/ 

Fetcn tne priority of tne rec2ive orocess | x f 
Fetch tne priority of the transmit orocess «x / 


LO 
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VE 


f/x 09 CASE on the Layer instance numoer to deaternine process nare «/ 
f/x CAS= This 3s Layer instance zero « / 
/e Register tne wall known mailbox name xf 


/*® return to tne calling */ 
fe Ff SRA _AETURN */ 


/= Set layer instance process name for tnstance O & f 
f/x set pointer to receive process nama x/ 
f/x set pointer to transmit process name */ 


fe CASE This i3 layer instance one xf 
/ex Register the well known mailbox name 7 
/x raturn to the calling */ 
/*e if ERR_RETURN #/ 


f/x Sat layer instance process name for instanc2 1 xf 
/x set potnter to receive orocess name */ 
/e set pointer te transmit process nam2 */ 


f/x CASE This is Layer tnstance two « / 
f/x Register the wall known mailcox name xf 
~ f/x return to tne calling */ 
( fe if ERV_RETURN ¥*/ 


/x Set Layer instance orocess.name for instance 2 . wf 
/x set pointer to receive process name */ 
/* set pointer to transmit process name */ 


f/x CASe This is layer instance three . xf 
f/x Register the well known mailbox name xf 


f/x return to the calling */ 
f/x YF TRRLVETURN */ 


/x Set Layer instance orocess name for instance 3 x / 
/x set sointer to receive process name */ 
f/x set pointer to transnit orocess name x/ 


/* DEFAULT ~- error | xf 
fe af ERR RETURN ef 


f/* END CASE xf 
/x switch */ 


/x SHOULD THE RCV AND XMIT PROCESS MSOXXES BE STORED AWAY 777? wf 
f/x Creat? a receive oroacess for this LLCO instance */ 


/* Create 3a transmit oarocess for this LL instance */ 


/* Request the OMA and I0 mbox ids xf 


Wi 
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f/x raturn to the calling *«/ 
fx if =2R_QAETURN */ 
/« Now 1 a matter cf waitinjg for request nox Jas ness3ge to return *x/ 


TIKI KK KK HK IK KK RK RE KEK KR KEK KKK EKER ER KEK KKK KEK KEK KK / 


f/* Request Mailoox Ids for 39 Dispatcher ana OWA procedure x f 

in | 

te TITLe: REQUEST MAILAOX IDs for 19 OLSPATCHER and DMA PROCEDURE 
*& 

* FUNCTION: Issues 2 message to the Controiler layer manager requesting 
* the IO Dispatcner and DMA mailoox ids. 

« 

*« Inout: Access to common system management data structures 

® Yeturn mailbox ia 

®& 

® Outputs: srror Status 


® 
te te Ht eR KK eK He eK RR KR KKK KEKE EEK REKKKKKKEKKRKKEKKEKHKKEKEKE 


xf 
4x Td ana IMA NOOK 10d rege MSge */ 
/* clear dSlock pointer */ 
/x block size */ 
f/x clear block counter */ 
/x Allocate some space2e for an TOLD sign in message */ 
f/* return to the calling */ 
/e if ERR_LRETURN x/ | 
f/x clean uo all mem moid_ptr */ 
/* Set tne priority and clear the buffer descriontors */ 
f/x Set the message type to register «/ 
/* Set return mailbox [ID */ 
f/x Clear the return code «/ 
f/x Turn response mailbox on «/ 
/* return to the calling */ 
fe if ERR RETURN */ 


-/* Send massage to CT LM to fetch ID Dis. and DMA =f 


f/x return to the calling */ 
Je if CRA_LRETURN */ | 


f/x Return | «/ 
/*® reg_io_dma */ 


LR HK KK RH HHH HK RK RKKEKK ERE KEKERKKEKEKKEKKEKREKKKKKKEKKKKKK KEKE / 


1s 
ww 
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| teen en nen 2 = Lie. bayer “inagenent. Sr sseea see e Tee ee 


/x« Tne TQ Dispatcher and OMA mailbox id reguest nas returned «/ 


{* 


a 


Xa RR RR KH RRA A 


Tees RECEIVE MATLSOX IDs for [9 DISPATCHER ana IMA PYXOCEDLRE 


FUNCTION: Receives a message fron the Controller Layer manaser 
returning th2 [0 Dispatcher and OMA maiibox ids. Thesa 
mailoox ids are stored away in the layer instance taste 
and th2 registration of the the function code nailsox 
directory with tne Controller LM is initiated. 


Inputs: Access to commen system nanajement data structures 


Jutput: Error Status 


[222 eRe SERERARABRARS AS AAS RSRPRAALRARASRARSAALASSARSL SR ALLSSREL AAAS ERR ERS ASSES ESE SG 


xf 


{x Pointer to the srocess variables */ 
fx Pointer to tne returning massage */ 


( 


/* 


{x 


Je Error status xf 


The signin message has returnec fron IOLD interface software */ 
This message has been returned from IOLD sign-in */ 
f/x return to the calling */ 
fe Ff ERR_RETURN */ 


/*x return to the calling wf 
fe if ERR_RETUIN #/ 


STORE away the iodisp and dma mailoox «xf 
Rel2ase the message olock to free memory */ 
Register with 9 Dispatcher the function code mailoox directory « / 
Je return to the calling */ 
fe if ERR_LRETURN */ 
Now 10 a matter of waiting for [05LD registration to raturn *f 


Return xf 


Je rev_mox_ids x/ 


[MH IKI HHH KR RE EKKKKREREKRKEKKKEKRARAKRKKKEKKEKKKKRKKREKKE KK KR KKKKKE EK / 


/« 


TITEES REGISTER FUNCTION CODE MAILEOX DIRECTORY 


FUNCTION: Issues a registration message to tne 19 Dispatcher 
a#hich contains a pointer to the mailoox directory 
of a LLC Layer instance. May oe used py other Layer 
9rotocols dy mocifying Layer value (Cine APORT - Set 
layer = 46) and redirecting error orocessinge 
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iNPUT: Pointer to function code mall5ox directory 
Return mailbox ita 
Value of Layer instance 


OUTPUT: zrror code 
J - success 


RMR ERK KER EKER KER ERE KREKK EK REE KRRE RHEE KHMER KK KEK KEK EH EK EK EREKEKEKEKK KK & 


« f 


{x x9 


gister -unction tsod2 Matlsox Direc cry routine xf 
Je PdINter to Layer Instance tadle xf 


/* Error code af 
/*x clear block pointer x/ 


/*x pilock siza */ 


f/x clear block countar x/ 


f/* Allocate some space for an [35 dissatcner sian in nessage */ 


/x 


{*® 


i* 


[* 


« 


* 4 & 


| f/x raturn to the calling */ 
Je if ERR_RETURN */ 


/x clean up all mem anoidg_ptr «/ 
Set the pricrity and clear the buffer sgescristors x«/ 
Set the messag2 type to register «/ 
Set return mailbox ID to this Layer manager instance mailbox */ 
3et pointer to function code mailbox directory «/ 
set channel for Layer (shiftec to left 3 bits) and Layer instance 
Clear the return code */ 
send message to I0 Dispatcner *«/ 
f/x return to tne calling *«/ 
fe Ff ERR_RETURN w/ 
Release the message block to free memory */ 


Return with error code «if 
/*e reg _fcmox_ dir */ 


fA SEeRESESERAEERLASERSESELEESRSSIE SSE SALESL ASSOLE SEL REESE LEE LARS EE SLES ALE 


xf 


eae Bae a ea Waa la Sere awe awe eG 1B © Ree esd-6e wae Sao dew OSS Oe eee A we SE 6 a es OS 
This is a collection of procedures that inclement and suprort thre three 
orocesses that are a LLC layer instance. They are constructed to take 
advantage of the ‘C* code oaraneter passina sy value and automatic 
variables to implement the reentrant charactaristics that will be 


Je Pointer to fe mocx sgirectory razistration messaqe */ 


* reyquirec to suoport us? sy several srocesses under the kernel. Some 

ke oroceagures, such as the megasus suopert routiness will 52 usad by all threes 
ek ofoceasses in eacn of tae four cosiotle instances. Tne value osarameters 

* and automatic vartaoles will allow simultaneous use %Xy tne three ocrocesseas 
x within any one tnstanc2? ang the Layer instance common area tastes will 

x orovide the contaxt for 2ach Indivicual Instance. 

WW we HHH HK RHR KEK RRR KR RK KKM ERK RK RE MRKKEKEKKK RK EREKEKEKKE KK 


«xf 


Lo HHH IK RK KR KKK REE RERKRE KKK HE EKEKKEKKKKKEK KEK RK KEK EK / 


i: 


a 


TITLe: CRIATE LOCAL LSAP PRICEDURE 


FUNCTIONS Receives a creat Local LSAP request message - 
creates a LSAP tadl2e and tntitializes it tne values 
contained in: the message. All statistical counters 
are reset to zero. No values are tefaulted. 


IN?UT: Pointer to mailbox messaje 
Painter to layer instance tastlea 


OUTPUT: 


+ * eA HH HR HR HR 


ai ec eBeRSREARESERRSRE PRARERRERA SRA RLAASRASRSRSASLARALAARASZA SS SAERARASL ASRS ASL AS 2S 


7 9 Te II HT HK I TK II ORR EK ERE RE KEE KEE KKEKE REE KKK EKA EK KEK KR / 
{RSS e eRe SSS er eas Seer een =—= LLC Layer Managenent 2-3 =4$s"4$<sseeSss>: £7 
fe This procedure creates LSAP tanles and sets initial values. The procedure 
* must o@ called with Create meassaye pointer 

x and a pointer to tne instance tanle that 


x tne LSAP 15 associated with. | 
Bete eeReeeeSRERREERELERSL ASRS ESR ARLSRALA LEA LESS RA SRARSELEASARAD RS SAARA RS SAAS AE SS 


«/ 


/x Pointer to create Local LSAP messace */ 
f/x Pginter to the intance tanle */ 
f/x pointer to create Local lLsap nessace *«/ 
f/x Pointer to a L.SAP table memory block */ 
/* Number of the LSAP 
/* Index integer for arrays */ 
f/x LLC error status xf 
f/x alock size */ 
f/x clear plocks pointer x/ 


f/x Cast an create Llsap message wf 


/*x Fetch Lsao numoer from LLC adaress «| 
/e fix for all dir start at 1 */ 


/x TF Lsap already existed xf 


/*x THEN there is an error xf | 
f/x raturn notice to the calling nosules bad_create request */ 
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cNOIEF xf 
AlLocat2 some soace far the LSAP tagla */ 
IF space was avatlaole than */ 


/* Set all initial valués tn the LSAP tadle x/ 
/ex glear the nane xf 


f/x AlLocate soace for tne activated ramote LSAP directory and clear 


4/x Initialize all remote lLsap entries to NULL &*&/ 
/* bt! WHAT T3 00 ASCUT GROUP ADDRESSES 
ix V§t WAT TO DO ABOUT GROUP ADSR=ISSES 
f/x Clear the jyrouod addresses 
fx Clear group acdresses */ 
/x cooy LSA? nane from message */ 


/* copy type 3022 from message */ 


/* sooy LSA? addrass from massage NZED TO REVISIT */ 


f/x cosy LSAP address from mnessa3ze */ 
/e* NEED TO REVISIT - WHAT to do apdnout 

adoress Length 
/xlsap_tcaole-r>lsaa_3aartt, 


/x set class to Li «/ 

f/x set venue to Local */ 
Je set stat2 «/ 

f/x set suostate */ 


f/x set MACS maposing */ 
/*® set to maximum numder of transnit sytes ef 


/* set to maximum numoer of receive byt2s xf 
/* set to type 1 */ 

f/x set to maximum PIU size in bytes « / 

/* set maximum receive creait «f 
/* set maximum transmit credit xf 


fe Initialize all working queues/,douffers and Lists 
f® NEED TO REVISIT 


/* clear tndicator flag «xf 
/x =nd of the List */ 
4*Ton of the List */ 


/e® End of tne List x/ 


f/x Reset all statistical counters 
4x NEED TO REVISIT 


fae 


«/ 


«/ 
w/ 


* fix for start from 1 */ 


*f 
af 


ra 
cf 


Tt «/ 
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( 


f/x pacjeve led queue counter */ 
/x recieve cau queue counter x*/ 
/x racieve lco queue counter e/ 
f/x recieve cau queue counter x/ 
/x Data octets transnitted «/ 
/x Data octets receives x/ 
fx UNKkNOwN commanas */ 
/* numoer of LOS transmitted *«/ 
fx number of LCS recetves x*/ 
f/x rpaceive connection ICLOs */ 
/* numoer of event TOLds x/ 
f/x numoer of active ICLDOs x/ 
/* UI frames transmittec */ 
/* UI frames recetved */ 
f/x XID commands transmitted */ 
/* KID comnands received */ 
/*® XID rassonses transmitted *«/ 
/‘* XID resoonses receives */ 
Se TEST commanacs transmitted *x/ 
f/x TzIST commands received */ 
Sx TEST responses transnitted */ 
4x TEzST responses received x/ 
f/x numoer of xmit ocu droped */ 
f/x numoer of rev pdu crosed */ 


( /* Save the address of the LSAP tadle in the acapter table +*/ 


f/*« Set status «f 

/x set source to indicate its an LLC status */ 
/x zero out statusiid to Indicate success *«/ 

/* set to ¢ cytes *«/ 

f/x set data to zero x/ 


fe ELS=e 3 bad request xf 


f/x Set status xf 

/* set source to indicate its an Lit status */ 
f/x zero out statusid to indicate failure */ 

fx s2t to 2 sytes */ 

f/x set data to zersd */ 


/* ENDIF */ 


f/x Set message type to tndicat2 a SM Confirm message «/ 
4x createa_lilsap */ 


(TRU SUSESESESESASSESSSEEESESSESESSEAESESERSSSSESESESESIESE SE LESLESEAS ASSESS ELS 
/x 
* | TITLE: CREATE REMOTE LSAP PROTEDURE 


FUNCTION: Receives a create renote LSAP request message » 
creates 3a remote LSA? taole and intitializes it the 
Values contained in the nessage. ALL statistical 

* | counters are reset to zerd. No values are cefaulted. 


* © 8 & 


*« 


HoH Te HH TE I RE HERR KKK KEK RK KERR KREK EK KEKE RK KK KKK 


*& 


[RRR ERERK RK KERR E KEKE REE KKK KEE RK RRR KE RK KEE KK EEK ERE KEK KR EKER KKK R EK 
This procedure creatas LSAP taples ana 


/ 
/ 


/ 


& 
& 


INPUT: 


OUTP 


JT: 
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Pointer to mailsox messaje 
Paxinter to Layer instanc2 taoale 


* must oe called witn Create message pointer 
* and 3a ovoiInter to the instance taole that 
* the LSAP 15 associated with. 


Lea PeReRERERALASARE RE SSA SASAALSALRERLSRAARSAASREASZSAE RASA SARA AR ARLE SAAR ARESR SASS S SLE SE: 


xf 


f/x Pointer to create Local LSA? message */ 
f/x Pointer to the instance table */ 

f/x pointer to create Local Lsap messase */ 
/* Pointer to a LSAP tandle memory blocx */ 


/* Numoer of tne LSAP~ xf 


f/x Index integer for arrays */ 


f/x Index into remote SAP directory */ 
/x clear pslock pointer x/ 
f/x block size x*/ 
f/« LLC error status xf 
f/x Cast on creata remote ltsap messase wf 
/* Call routine to searcn remote SAP sirectory for remote adiress 
fxreturn(CRUR_LSAP_LERR) o ef 
f/x return sad status */ 
f/x Call routine to search remote SAP directory for next available entry 
/*e raturn to the callina */ 
Je if ERR_RETURN «/ 
f/x Allocate some space for the remote LSAP taole */ 
f/x IF no memory availasle for the remote LSA? tasle «/ 
/* THEN there 315 an 2rror xf 
f/x return to the calling «/ 
Je Gf ERV_RETURN *#/ 
LF xf 


/* END 


s2ts tnitiat values. 


Tne crocedgurs? 


4x Set pointer to remote LSAP into next directory entry */ 


/ejinerement index *«/ 


I Initialize the remote LSA? taole « f 


/« 


WHAT TO DO ASIJUT REMOTE CROUP ADDRESSES 77? 


f/x Clear croup addresses */ 


af 


xf 


x / 
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fe cooy LSAP name from messase */ 

/*« copy tyce 8022 from message */ 

{x Cody Lsao aadress Lenytn into remote (sap tadle xf 

/*x copy LSAP adaress from message NEED TO REVISTT address Length 


f/x sat class to LL #7 

/*x* set venue to ramote *f 
/x* set state x«/ 

/* set sudstate */ 


/x set to tyoe 1 */ 


/x initialize log. adore x/ 
/x clear indicator flag =f 
fe clear currant number of act. x f 


/* Reset all statistical counters « / 
f/* NEED TO REVISIT xf 
f/x Data octets transmitted «/ 
/«* Data octets received */ 
f/*« Unknown commands */ 
/x JI frames transmitted */ 
f/x UI frames received */ 
f/x XIT0 commands transmitted */ 
f/x XID commanaos received */ 
f/x XID responses transmitted */ 
/x XID responses received */. 
/* TEST commands transmitted */ 
f/x TEST commands received */ 
/x TEST responses transmitted *«/ 
/* TEST ressonses rac2ived */ 


f/x Set status xf 

fe set Source? to inatcate its an LLCO status */ 
f/x zero out statusid to indicate success */ 

/* set to 2 bytes xe/ 

f/x set data to zero */ 


/x create remote lLsap */ 


aed 
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[att REE RESERESERERSERERSSPSARERERESE SESE SEESESESS REPS RSLS REESE L aS Ss 

WM HMR RK KR KR KKK KR KK EKER KERR ERK KEE RRR KK RRR KHMER KEKEEKKEKRKRE KEK 

Kk & 

x*K 

xK* HONEYWELL 

KX 

RK 

nk Local Area Network 

x*w* 

x vedo rC AL L IN K ve JN TROL 

wk 

kk * LAY=ER 

kek 

xk | receive module 

xRxXxw 

“ww 

wk x Cooyright: Honeywell Information Systen 

ke & ALL rignts reserved. 

"wx 

kkn Cereate Date: 1/25/85 

eke ay: De OShaughn 

te % Discription: 

xe * 

te te Revision #: 1 - 
& & Date:. 3/25/36 . ee 
ke & 3y: 46 Lu 

ax & DISCcriptions 

a _ 

eke Revision @: 

we Date: 

ee« 3y: 

* & Discristion: 

wn 

nw x 

axe Functions & Paraneters: 

®& 

* LlLeoeorx_linir Clica_p) 

te LISA wxlica_p-r * Pointer to the dcayer instance common area * 
* Lle rx Cmbxotremox name) 

*® MSG *moxotr, 

* MEID mox_name,s 

® rev_ilecbi_to_tac(mbxptr-lica_o) 

* MSG *moxotre 

* LIcA *xlica_p- * Pointer to the orocess variables * 

al rev_ouf_to_l5(moxotreslica_p). 

*® MSS *moxptr, 

x Lila xlica_p, 

se mac_ina(nbxptreslica_p) 

* MSG *moxotr, 

* LICA *lica_ps * Pointer to the orocess variables * ye 
* validate_odulindmsgr,ilc_framessr_log_addarslica_p) ar 
* DATA_IND_MSG *I1namsgs * Pointer to tne data Indicate message * 
* LLCLFRMS xltc_framass * Potnter to incoming frames * 
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LiCA welica_p-e * Potnter td the orocess variables * 
send_buf ta _léClle_trans/lica_a) 


LICA *lic3_94 * Pointer to the srocess variacles * 
aging_alarm(noxptrslica_o) 

MS a *mMoxstres 

LISA xlica_ps * Pointer to the srocess variables * 


he An HO x am 


kkx 
xkn« 
‘eee eee e RARER RR ERAS SE REARS SAS AERARSAS RES SAS RRS SES RR ES ORR ER SS SE OS Ee eS 2 
‘RaERES RASA ALAS RABRAALARARSRELAARRALSA ERAS SRALRSRAARAR SAS Ra EASA SEAS SRSA SRA EES E @ | 


wf 


FH HH KH HHH KR KR KEKE KKK REKEKE KK KKEKKEKEKKEKKKK eK / 


fx 


This code initializes a receive precess for a ilC Layer instance. 


14 


ce cee oe LLC RECEIVES INITIALIZATION PROCEDURE 


! 


FUNCTION: Initialize tne Recetve process by storing 
the pointer to the lLaye2r instance common table 
in tne receive process Pts. This procedure 
also create the mailboxes required for transmit 
Qo02ration and stores tneir id in the function 
code mailbox directory 


INPUT: Pointer to Layer Instance common tasle 


OUTPUT: 


t+ ett t 4 Se 2 ee eR OF 
‘ie 


« 
-222 2 SRS SERRE SASSASAAASASSAEERSASRARA SSR SARARABRASRA SES AES RERALAALR AALS SAE SE & 2 


xf 


LM HH RHR RK RRR MEK KEKE RKKEKKKREKKEKEKKKKKaEKK 
/* Tne following conventional *C' coae heaszer file is used 
ek oy tnis orocesse See the respective files for definitions, 


* structures and macros. 
TERS HRRERSOEREERERERESRPAARSERARLERSSRAREAAEARARASSRSEASEARASLAAARSASSL ESS? 


x / 


{x START xf 
f/x Save the pointer to the LICA taote for this instance */ 


/*e NEED TO REVISIT «/ 


/« Create 3 mailaox for receive functions» save dgefault for alarns 
/* need Limit to 15 or sos and error condition detecting handling */ 


/w Add LLC Receive mailpox id to the function directory */ 


f/x Create the mailoox for MAC_DATA.Iindication messages */ 


u_lon3 *r_loj_adars * Pyinter to rencte LSA? Logical aadreass * 


LLE_ TRANS *«lle_transs * Pointer to the LLC transaction olock * 


ig ca: abe eae Oe 6 eee aaa eo LG Receive [HAE Va C12 at 1 ON <-66 6:6 eee ew ewe ww ae eee ew aw es 
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ff ~ \ . 
-_ 
/* NEED TO ALLOCATE AN EWSRGENCY MESSAGE x / 
/e wiY DO we NEED THIS ef 


/« Declare steo 2 Initialization comoletec */ 
/*x END « / 
} f/x Lleo_rx_init *«/ 


IEA REEEPEEASEAAEESESEOSESESESESAESESRESAEAS RP SESASESSSEASSESESSES ASSES SS 
fir 
iH isa. seas aca eewae ee LL. RECCIVG “POCESS  canwise weece ee cewes 
This is the operational receive process code for each LLC 
layer instance. YWailoox nessages raceivedt witl de decoded sy 
the switch statenent into srocedure calls for the cases Listed 
Jelow. Each call will pass a pointer to the nessac2 and che 
oot1nter to tne LIiCA tadle as Carameterse 


% 


TITLE: LLO RECETVE PROCEDURE 
FUNCTION: Receiv2s all messages directed to the LLC receive 
Qrocess for a Layer instance. It then determines 
the correct procedure to call to process the request. 
INPUT: -ointer to message. 
Mailoox name ~S<-==—= what for 7? 
QUTPUT: 


C6666 Cee eee dew wee aene LG. ROECCTVE PFOCESS -siwwe eae ewes 6 oeee ae 
THIS tS the operational receive process code for each LLC 
Layer instance. Mailoox messages receiveed will oe decodad psy 
che switch statenent into procedure calls for the cases Listec 
9elow. Eacn call will oass a odinter to the messace and the 

* 90Inter to tne LICA tadle as parameters. 
Zee eeaeeeSaARSAALSO SAAR SER ERE SAAS SPRAE RRS MRSOREARSABARSASRESAAAZSERESR DE EES DS 


nf 


ee ee ee a ee ee 


/* Retrieve the Layer Instance Common Area pointer */ 


/* 30 CASE on message tyne *«/ 
fx CASE DATA.INdIcCate messaze from MAC */ 
/« Call procedure to receive a FOU from tne MAC Layer */ 
/* SHOULD 82 RECEIVING AND ChRECKING AN ERROR CODE HERE / 


4x CASE An TOLD request message */ 
f/* increase LOLDs counter for statistics */ 
fx Call common routine to transfer LOSI to LACS from IOLD msaq */ 
f* SHOULD GE RECEIVING AND CRECKING AN =ERR0R CODE HERE xf 
f/x CASE The request to OMA a LCSI to the LACS nas returned */ 
f/x Call procedure to interpret new LC3I * f 
/* increase LC3B to Lacs counter for statistics */ 
f/x SHIULD SE RECEIVING AND CHECKING AN =RQ0R CODE HERE f 
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/* CAS2 The request to D*A ga ouffer asescristor ts the LACS has raturned «/ 
f/x increase ouffer to lacs counter “cr statistics */ 
~f/xe Call routine to fetcn data ouffer from LS wf 
$x SHOULD SE RECEIVING AND CRKECKING AN =ERQOR CODE HERE af 


f/x CASE The request to OMA a suffer tc tne 1.5 has returned */ 
f/x Increase suffer to t5 counter for statistics */ 
f/x Call routine to request tedi b2 moved to LS */- 


«/ 


Ths 


fe SHIJULD SE RECEIVING AND CHECKING AN ERROR CODE HER 


fx CASE The reguest to OMA a LOLI to the Lo nas returned *x/ 
/* Call orocedure to terminate LC3I and free all memory *f 
/x increase LES to Lé counter for statistics */ 
/x SHOULD 8E de making sure all memory returnec * / 


J* SHOULD Se RECEIVING AND CRECKING AN =RROV CODE HERE xf 


fe OTHERWISE */ 

f KR RM HHH RH CREME RRR KKK KK ERHE KR KEKE EH RK KEM KEK ERE REKRKREKREKEKEKEKEKK 
x The massajzge can not oe decoded into any tnat are expected by this 
®* orocesSe 
x At this stages the soace used 
x sy the nessase is returned to the kernel 
* until a method is designed to hanale the proolem. 
TAOS ERSERPRDSEFERABLESERSRARSARERARPAAALALARSARSL ALAA ARRE SAAS ESR RAR SSR SARE RASS SE 


x / 


/* set up unknoen error counter */ 
/* sena event message to the sme */ 


fx ENDCASE End of the message tyoe decoding */ 
} f* Ulec rx x/ 


LHRH KKK KREMER EKEKKKKKERKKKKKKKKKEKK KK & / 

[t SeSS SSS Hansa a eee ane ME GPOUS. LNtOT (aCe See eae Se Saas «f 
/x The request to OMA 3a LOSI from the L6 to the LACS nas returned *«/ 

jx 


* TLLEes INTERPRET RECEIVE LOS REQUESTS PROCEDURE 
® 
* FUNCTION: Receives all DMA confirm messages due to the comolatian 
* of a transfer of a LCBI to tne LACS memory. This 
* routine determines if an additional transfer of a 
* auffer descriptor is required and sends a message to 
« the DMA software if it 18s neccesary. If a ouffer 
« descriptor is not associated with tha LCOS then this 
* orocecure will determine whether this is an event LC3 
we or connectionless read request and call the aooropriata 
t orocedur?. 
* 
a INPUT: Pointer to message 
pointer to the layer instance taole 
*& 
t 


OUTPUT: 
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co~ 
7 
x 
RRC KKH RE RE RRK KKK RK RE KKEERKEKRRKEKKKKKEKKEKEEE KEK KR KEKE KEKKKKRKER 
xf 
LR RR RK KR KKK KER KKK REE EK EE KK KKK KE KKK KERR EK KK 
* Tnis nessage HaS Deen fraeturnecs from CMA S@rvices. Tne following 
x coje witli check the results of the 
x transfer request and aeternine if it was 
* successful. 
A2 SBERSERSASAEBOSEALRSSAEALZSASASRRASZAEALEAALEAAASDABRSAESDSSESASA REARS SALAS SSA SE 3 
wf 
fe Local Lsao index (equivalent to Logocal aadress) */ 
f/x Cast ona transacation block structur2 «x / 
f/x ITF the request was successful */ 
{x THEN «/ 
J* 30 CAS= on tne function code in the LC3I xf 
{x CAS= of an event LC3 xf 
J*® EVENTS ARE NOT SERVICTCH=AD UNTIL LATER «/ 
f/x CASS of a Cannectionless reaa request x / 
4x fetch tocal sap index */ 
a 
f/x ITF the LSAP numoer is valid and the es 
LSAP 35 ACTIVE CINUSE state) *«/ 
f/x Set the local lsan tadle sointer tnto transaction block */ 
f/* Set the Local Lsao Logical address into 
transaction oloc« ef 
im Me EERESESESSEASESLASLSESESLESAESSE SESE SSE SESS ESCOLA SSCS ACES SSS ES SE SS 
* wWnen the suffer pointer is tn the LCSI-, a search of the 
x waiting ocu * queue is made. If one is founds tne LCBI 
xe will be completed and returned, otherwise tne LCSI will 
* be adced to tne ‘waiting LCO3I* yueue. 
MRK GREK HRM RR K KR RKK EK KKK RK KKK KKK KEKRKEKEKAEEKKKEERK* 
xf 
f/x ITF the odu waiting queue is ampty */ 
/* check bound Limit */ 
/* over the sound Limits dros the request «/ 
f/x Sat LOSI function specific 
| status to queue full *«/ 
f/x sat the read credit count for 
Les usar flow control «/ 
f/x Indicate LCSI completion in the status */ 
f/x Call common procedure to return LCal xf 
> /x if x/ aa 
f/x else go ahesaca to gqueu2 up the request */ ee 


f/x usdate the gquaue counter */ 
f/x Ago the transaction olk to the end of the 
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waiting list */ 

> {x alse ref 

f/* =LSE (There are pau's waiting) */ 

f/x Fetch first transaction olk containing th? 
data indicat? */ 

Je Set the LCél actual size from tre waiting 
9tU transeolKx. */ 
/* sudtract tnree for LLC header « f 


f/x LF LC3 buffer is large enough to contain tne PDU «/ 
/* Need to subtract tne Lle aadress header x/ 


f/x THEN sence it sack to the Lo a f 


/* Renove tne first message from the 
| waiting queue */ 
f/x delete it from queue «/ 
/* update the queue counter x*/ 


/x Strip off LLC heager from 
PSU ano set suffer dese into transealk x/ 
/® EXTRA STRIP OFF HEADER GET CUT BY MM. LU 2/19/7354 


fx Copcy all oertineant info from 
{ f* L45 memory pointer */ 
qt . f/x Buffer Descriotor pointer */ 
f/x Lo Suffer Descriptor oointer */ 
fe ELCSI size *f/ 
/* channel stuff = */ 


f/* Return the suffer to the Lo */ 


f/x Free memory of transaction block 
| containing the LCBI «/ 
} fx if «/ 
fx ELSE Return LCB with status «/ 
f/* Set LCYI function specific 
Status to suffer too small *«/ 


/« set tne read credit count for 
tco user flow control */ 


4x Indicate LC&I completion tn the status */ 


/* Call common orocedure to return LCII «/ 
fx ENDIF «/ 
/*® ENDIF «f/f 
J/x ELSE pad LSAP «xf 
i | Jx Uodate LCSI to reflect bad Local LSA? xf 


f/x set the reac credit count for ted user flow control «/ 
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wa 


a 
| oF 
fx Indicate LOSI completion in the status *«/ 
fe RAaturn Logi te v5 « f 
fx ENDIF wf 
/e CTRMEFWISE dad functisn cocae «xf 
/x Upaate LtSI to reflect oas function crce «x f 
/* set the read creatt count for Leb user flow control */ 
f/x Indicat2a LCSI comoletion in the status */ 
f/x Return L(C3I to Ld xf 
/* ENOCASE x f 
/e 2LSe x/ 
/x Set invalid status in the LCSI «/ 
/=x« Update LC3I to reflect dad function coda? «/ 
/x Set status tn HW error word 7727777 : wf 
/* set tne reaa cradit count for Lcb user flow control */ 
4x Indicate LCII- comoletion in the status */ 
/* Try ta send it back anyway « / 
Je ENOIF w/ 
} f/x rev_ileni_to_lac */ 
[HK te MRK KER KKK KEKE EK KER KKKK EKER KKEKEKKKKEKKKKKKKK / 
[xk Sl sstese see erase e see S essere s= Mesa ous Inter tics S398 9S5S<444 546" Sa5e2=>5 * f 
/*« Tne request to OMA a ouffer to the LS fas returned x/ 
/ cw MRR KAKRREKREREKKRKKS RRKEKKKKKKKKEKAKRKEKKKEKKEKEKKRKKEKEKKKEKE | 
/ FO MMW RH HK HK KREUK KKK KKK RK RR RK RE RHE REKEKKKEKKEKEKKKEKE RE KKEK a, 
* THIS message is returned by DMA services when it comoletes the 
* transfer of a buffar fron the LACS soard to the L6é as part of a read 
® transaction. This step will set the status in the LCSI ana request OMA 
* services to return tne LCS to the L6. 
‘eee eaEeES aS SARABRAaSLRERRSaSBSALESREARASARASASSSaALARBASCEALSALASZAESRLARR SARE SASL EAS | 
& f 
/« TF Buffer transfered witncut any proolems af 
[x THEN x / 
f/x set the read credit count for Leb user tlow control */ 
/x set remote Logical acdress */ 
f/x Inatcate LS3I complation in tne status */ 
f/x Raturn the iLC3I to Lo memory */ 
} fe if NULL ¥*/ 
f* ELSE | xf 
f/x Set status in LC3i accordingly « / 
/x Set status in Hw error word 2727977 * f 
f/x set tne read credit count for lcb user flow control */ 
f/x Indicate LC3I completion in the status */ 
/* ALL MEMORY WILL BE FREED AT COMOPLETION CF LCBI TRANSFER */ 
f/x Return the LCSI to £6 memory e«/ 
} f/x else «/ 
f/x ENDIF if 
} f/x rev_buf_to_l6 */ | 
| : fe 
/ te Rae RS RERESRASBSRASERSRSSARESERESBRSaSASERLEASSSRSEASZAAZRERSESASELEAERSE LE 2S : Ne y 


* 


LLC LAYER XID RESPONSE PROCEDURE 
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C 


* 

® call: LLe_xiaCinamsgrlica_9o) 

& 

© FUNCTION: 

fe when recieve a XID resuest from the LAN 
« LLe Layer will set up response mnessaze 

" and send oack to tre XID reyguest source. 
 g 

® DESCRIPTION: 

® 


‘2 e2en eee SERRE RL SLES ERARARERAARAASLAMRAASRSARASAE SRE RARABRAR AAA RS OEE 


wf 


f/x Potnt to the ocuffer */ 
f/x Call procedure to validate the 90U request for tnis SAP «f 
fe IF it 1s a valiu PDU / 
fx Fetch the local LSAP tabdle 
Jgnore yjyrouo addresses for now */ 
/* swap the Llc adaress «/ 
f/x cast to cata request messase */ 
f/x updating xid xic counter */ 
f/x count out address for xic nessage */ 
f/x gut In xid ressonse information */ 
/*® stander info x*/ 
4g /* gut Lsac name */ 
( f/x get lsap nane */ 
/x set mnessajze tyce xf 
f/x set the ortcrity */ 
/* Sw3p tne mac address */ 
} f/x for x/ 
fx Sutin own mac address */ 
/xstrepylrinamsg->layer.mac.source_addr.octetst lsan_ tbi- >mac_aigr)sr/ 
/xfor Cincex = Os Index < L_tsao_tbl- >mac_adr_ingthn: indext+) 
> x for */ 
f/* sanc to nac for tranfmit out */ 
/* free tne message */ 
/x update message croosec counter */ 
/*« free tne message */ 
} Je else 1f M3Xfull */ 
} /x VF Lhlcerr xf 
f/x Droo the tncomitng pausr the LSAP 18s not aefined */ 
/* update oud drop counter */ 
f/* Free tne MAC message */ 
} f/welse x/ 
> fx end ilc_xid */ 


FRR MHI I RH RK KK RHEE KERR KKHERKEEKEKREREKKEKAKRKKKKKKKK 
* 


* LLC LAYER TEST REQUEST PROCEDURE 
® 
co call: Llhe_testCindmsg,lica_s) 


& FUNCTION: 
* when recieve a TEST request from the LAN 


& 
4°] 
2 
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Lle Layer will set uo resconse message 
anc senc sack ¢0 tne TEST request source. 


aR KH 


DESCRIPTIONS: 
6 


WRK RRR RH RK KK RK KK RE RE WE KKRKKR KR RE KRK KKH KERR REE KR KKEKRKEKRKKEKE EK K 


xf 


f/x Print to the suffer x«/ 
/x Call aroceaure to validate the PDU request for this SAP x / 
Je IF ¥t 38 a valid FDdY xf 
Jx Fetcn the Local LSAP table 
ignor2 group addresses for now */ 
f/x swap thea ile address */ 
/* updating test counter x/ 
/* cast tO data request message */ 
/* set nessasge tyse */ 
fx set the eriority *f/ 
/* Swae the mac acaress */ 
4* Qutin own nac address */ 
/xstrecpyCrindms 37> layeremac.source_acar.octetsl_lsac_tbl~>mac_adr)sx*/ 
/xfor Cindgex = Qs Index < L_lsao_tol~>mac_adr_ingth> indext+r) 
/« send to nac for tranfmit out */ 7 
/x free tne message */ | 
f/x upsate messajze dropoed counter */ co” 
/* frae the message */ - ; | 7 
> fe else if M3Xfull «/ 
> j(¢w Tf Lheerr */ 
else f/x pad tast odu */ 
4/* Drop the incoming acus the LSAP is not defined */ 
/* update pud drop counter */ 
f/x Free the MAC message */ 
- fx end Lic_t2ast */ 


/ Rew KK RRR KR KEK HH KH RK KKK RK KRM ERKERKK KE RKEKREKKKKKKKRKEK KK RK zk] 
/ xr ws ecewoe 0 On a DGD OD 8 ee 8 Oe Oe oe @ oe LLC SAP C omponent 1 a De ee eee OPO Dee we oe we « / 


* TITLE: VALIDATE RECEIVED PCY PROCEDURE 


FUNCTION: Validates a odu received from the “MAC data 
incicate mailbox. It determines if local and 
remote LSAFs have been defined for the tayer 
instance and whether they are in the prooer state. 
in addition the PdU size is checked against the 
maximum POU size for this SAP. The remote lsao 
Logical aadress is returned as well as the error 
StatuSe 


INPUT: Pointer to MAC cata indicate message 
Pointer to LLC POU 
Pointer to Layer Instance common taole ¢~ 


* 44 ee HR He HR RH 


OUTPUT: Pointer to Remote togical address 
| zerror status 
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& 
WHM KKH RMR RHR RK CK KEK HE TEM EK EKER UKE ER RAEKEKAMHKKRERKEKKAEKRKKE EH 


xf 


Je & YWAC_OATA.INAICAte message ev/ 
f/* Clear an error flaj xf 
f/x Validate? thea lLogtcal adgreass of the remote ana local SAPS */ 
/x TF the Local Loge SAP adcr. Csame as the OSAP) 
1S greater tnan the ioccal LULSAP air. size */ 
/* Resort a failure */ 
f/x Set arror code */ 
fe ENDIF */ 
/x Fetch the tocal LSAP taole 
ignore grouc addresses for now */ 
f/x Validat? that tne Local SAP exists «f 
J/x TF the Local LSAP aoes not exist */ 
Je set the stat2 of tne LSA? and payee Instance accoraingly */ 
f/x Set LCZI status words | & f 
f/x Reocrt a LSAP failure */ 
/x Set error cose */ 
f/x ENDIF */ 
/* Validate the state of the layer instanc?2 « f 
f/x TF tha Layer instance is not In the INUSE state */ 
/x Set the state of the L3AP ana Layer Instance accordingly */ 
ae /x Set LC3l status words ef 
( f/x Report a failure */ 
fe Set error code */ 
/x Validate the state of the tocal LSA? | af 
f/* TS5 THERE A PROBLEM HERE IF THIS CODE IS EXECUTED EVEN THOUGH 
SAP IS NONTEXISTENT 
access undefinea memory 
~ Sus 2rror &f 
f/x IF the major state of the LSA? is not INUSE xf 
/x Set the state asf the LSAP ana Layer Instance accordingly */ 
fe Set LOSI status words xf 
/*« Report a LSA? failure «/ 
/*® Set error code */ 
/x ENDIF x*/ 


/« Validate that the LSA? Limits are not exceede4 wf 

/* IF the POY size exceeds the maximum P9U size « / 
/x Update statistical counters nee LSAP anc Layer instance accordingly */ 
fx Set LCal status words xf 


/* Resort a POU failure x/ 
/*x Set error code */ 
{/® ENDIF x/ 
{x Validate the Remote LSAP « f 
/* Fetch the full remote LSAP address (tle + mac) xf 
fx Fetch the remote LSA? rable » Ignore group addresses for now */ 
/x If the S$SAe (remote SAP) has oFen not activated 
and local LSAP parmits dynamic agdition to Activate diractory */ 


ae /*® THEN wf 
(_ f/x Acd the remote to activated List *f/ 
f/x Allocate memory for 3a remote LSAP taole2 «/ 


/« all procedure to search for next available LSAP entry */ 
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/x ELSE IF ramote SAD AaS NOt been Bctivates «f 
/« Update statistical counters for 
LSAP and Layer Instanc2 accordingly *«/ 
/x Set LCSI status words xf 
f/x Racort a sad remot> sA? failure «/ 
/x Set error code */ | 
fx ENDO JTF x/ 
Je Set remote Logical agcaress te activate directory index 
} Je eno Llheerr == NULL */ 
} f/x valiaate pdu */ 
LM HH HK KK RK RK KKK HK KKK RE KEKE KEKE KEKE KKREKKEKER 
® 


LLC LAYER MANESER DEACTIVATE FUNCTION 


® 

* H 
This function will clean up all Leo ausue Llc_trans 
* olocks, clean up all pau queue ilec_trans dlocks. 

x set uo locket states ana post sack all leas 

" 
x 


RRC EK RR RK KREMER KERR RKRKEKE KK KEK KE KK EKKKEKRKEKEKKKEKEKE RK / 


f/x get the lL -sap_taole otr */ 
/x validate Lsap tanle */ 
f/x set up Layer NULL ***LOCKX stata «/ 
> Je end if */ 
/x return not valid lco error */ 
f/x completed with error .*/ 
/x return the bad les ¥/ 
/x yet out nere */ 
} f/x els2 */_ 
f/x gull thre Local lL _lsao_table addrass */ 
/*« get the L_sap_tanle ptr x*/ 
f/* djelete from the lcd queue */ 
/* xernal macro function foir queue */ 
f/x jet the on just take of the quaue x*/ 
} f/x if «ef 
/* loop to cleaan up Leds queue trans olk */ 
/x for Level o informations leo raturn x*/ 
/« Level > completion sit set uos and err status set */ 
4x gost back Lcbi */ 
/x delete from the Led queue */ 
/*« kernel macro function foir queue */ 
/* jet the on just take of the queue */ 
s f/x unile */ 
fe get the original trans */ 
f/x keep track tne odu cropped «/ 
f/* get the next pdu trans at the queue */ 
f/x sump tne trans bLK */ 
/e jet the next one to check out */ 
P Je if «/ 
f/x clean the oagu queue */ 
fe xeep track the pdu dreped */ 
Je get the next odu trans at the queue */ 
/* dump tne trans olk x/ 
/e get the next one to check out x/ 


ef 
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? Je while */ 
/* get the orisinal trans */ 
f/x for clean the r_lsao table */ 
$* tooo to claan whan r_lsaod tadle not amoty */ 
f/x NJLL the r_is30 table pointers x/ 
/*« counter */ 
> {f/x wonile */ 
/* sena event message to Syst2nm management 
{« 
Send avent messag2 to systen managsenent mocule * 
xf 
f/x return event Ledi for completed aeactive */ 
/* tha Last leoi needa to set up and sens sack */ 
f/x set up for Level & completion cit and err status */ 
/e post oack Leoit */ 
} f/x tle _lme_ca «/ 


[Ve HHI IR KK RRR KK KER ERE KE KRKK KKK KEK RKKKKEK KEKE KKK KEKE / 
fn —_ <a a ap RD oe DOD OD an ee Dn ee Oe en OD a a ee ae we LLC Layer Manajzyement << << a > DD a oD ee Oe am ee ee oe oo ee 2 am <2 cw oe xf 


/x Massage aging alarm message */ 
LK CK KEK KEK KREME KK KKK KEKE ERE KKK KEKE KEKE KKEEKEKKKKKKKKKEKEE 


ieee eaeeeRPRREAS SARA ARAR ASA SASRSASASARSeAAEAZARERAARS RESALES AREAS AASSaASL SSAA AAD OS BE & 
This message 1s the returning alarm requast from setalarm. ALL tL_odu 
messages attacnedj to all 
LSAPS will be aged one time increment. Any nessacge : 
tound to be over the age Limit will 5e released bacx to the buffer sool. 
Tne assumption is that overagsed messaces are unexpected and a LC3 will 
x* never be Issued. - 
cee eRe eo RERSER aS SERRA SSSA ERS RSARSRASABERASAAAER SAS SES RL RARRAE SAA SESASPRSBRESER RAED ASE Sf 2 
xf 
f/« IF this tnstance 15 In the ready state tnen x/ 
fx FO? each [ctez3s32 aefined LSAP that can exist */ 
/* Potnt to the ~SAP table */ 
/* IF the LSAP has been defined «/ 
/*« DO for each message on the wailtinarpdau queue */ 
/*x Increment the aging counter */ 
/x IF tha aging counter is GTZ the Limit */ 
/e Remove tne message from th2 qu2u2 */ 
f/x uodate the queue counter */ 
f/x Release the memory to tha memory pool x*/ 
f/x Notify SM of the event «/ 
f/m ENDIF x/ 
fe Roll thru tre queue to the next entry */ 
fx ENDDO x/ 
Je ENDIF «f/f 
/x ENDFOR *f/ 
f/x ENDIF x/ 
/* Request the next aging alarm oerioa «/ 


— 


( 


* © eH RR HR 
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FRI KM RH KKK REE KK KKK RK KK KE KKK KE KKKKKRREKK KK 
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MONEY wELL 


Local Area Network 


oe GS Re L IN K 


transmit moaule 


CON TF FO 


Cooyrignt: Honeywell Information Systam 


ALL rights reservece 


Cereat2 date: 1/2578 
3y: De. YUshaughna 
discription: 


Functions 4 Parameters: 


Lieo_tx_init Clica_a) 

LICA *lica_ps * Pointer to the 
Lle_tx Cmoxptresmdx_namea) 

“SG *«moxotres 

MSID mbox name, 
xmit -lesi_to_Lac €moxatr-lica_p) 

MSG «emoxotres 

LICA xlica_ps * Pointer to the 
mac _conf_err(moxotrelica_p) 

MSG ®moxotere 

ICA elica_pe 
xmit_buf_to_lac€moxptre-lica_o) 

MSG *moxptfe 

LICA *lica_ps 


Layer instance common area * 


process 


validate_cata_req(llc_trans-lica_p) 


LLO_TRANS «lic trans, 
LICA *lica_pes 
Iss_mac_dreaql(tle_transslica_p) 


LLC_TRANS «lle_transs * Pointer to transaction olock for LLC POU * 


LICA *lica_pe * Pointer t2 
Revision 4: 1 
Dates 37 25/89 
sy: Me Lu 


Discription: 


variaoles * 


the instance table * 
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wk Revision #: 
exK date: 

kw sy: 

xk JIscristion: 
KR & 

| > ag 


RM KK RIK MRR RHE RHR RAKE KKK RE KKH RERER KREME KKEREKREKKKRE KEK 
Tae eSeRERSSRRE SSSA SRSSARARRSASSASAAAALASRALAEASE SAAR RAR SRASSRER SEARS RASS S DSSS SE SE : 


xf 


LR RRM EK KR RK KEKE ERE EK EK EKER ERK KEKE KKK EE KK EKKEKK KEK KEK KKK / 
/* 

x 6 ~ sees eee we biele eeee ewe tlt Layer “and COMO td «seas desea eee ee eee 

This is the LLC Transmit Process that exists once for each 


* 


* LLC Layer instance created. The comoination af this orocesss 

x the recieve process and the Layer managenent process constitutes 

* gne c.LC Layer instance. 

ef 

/« | 

© LEV. : LLC TRANSMIT INITIALIZATION PROCEDURE 

x 

* FUNCTION: Initialize the Transmit orocess by storing 

te tha pointer to the Layer instance common taole 
* In the transmit orocess 2PC3. This procedure 


( also create the mailooxes required for transmit 
| Qperation and stores their id in tne function 

* coge mailSox cirectory> 

bd : 

® INPUT? Pointer to Layer Instance common tadtle 

® 

® QUTPUT: 

* 

Ng ae bee; Wona ee a ee ae eae bis Transnite TAVt5 al 1 2a tC 1 Owes ete esse eee bw Steateé 
* Tnis code initializes a transmit orocess for a LLC Layer instance. 
® 


22-22 oe ee eee RLOLE SESE RE AAaRASLEAELESARARS ER RSRRARASRSL SSE ARAAARARASSAARSARSASRA LE SD 
xf 


i ae aReaRERSSSSERAAESASZARSAREARSaALSARS SEALER ASLSAAARSSASEARASLSSAALSRS RASS AAAS E SAS & | 
x Tne following conventional *C* code heager fiie is used 
* oy this process. See tre respective files for sgefinitionss 


* structures and macros. 
ee eee SSASEEASELESSS SERS EAERSE LSA EEL ER ELAS ASS LERE SEE SES LELE LECCE SSS AS SELES AS | 


xf 
fx START «/ 
/x Save the pointer to the LICA table for this instance x/ 
f/x NEED TO REVISIT «/ 
/x Create mailsox for transmit coerations xf 
i save default for alarns */ 


f/x Add LLC Transmit maitoox iD to the function directory */ 
@. /¢* NEED TO ALLOCATE MEMORY FOR AN EMERGENCY MESSAGE xf 
( /* WHY DO WE NEED THIS «/ 

/x Declare step 3 tnitialization comoleteda */ 

fw END x / 
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+ fe tle_tx_tinit */ 


ix 

KR KR HK RK KKK EH KK RK RE KEKE RRR KKK RK EK RK RK KKK KEKKKKE KK KEE KK K 
te 

TITLE: LO TRANSMIT PSOCEDURE 


FUNCTION: Receives all messages cirectea to the LLC transmit 
orocess for a layer instance. [It then deternines 
the correct procedure to call to orecess the request. 


INPUT: Pointer to message 
Mailoox name seas = yhat for ? 


OUTPUT: 


‘CDAD R ESCA Se~ee LLG TRAASMY? PFOCESS: 66666 ieeesewawwue~s 
This is the operational transmit orecess code for each cL 
Layer instance. Mailsox messaces transmites will o2 decoded cy 
tne switch statement into pracedure calls for tha cases Listes 
Selow. £acn call will dass a pointer to the message and the 
sointer to the LiCA taole as parameters. : 
SERA RESBASLEAALSASAAASAASGRARASSAZASBALA SASS RSL ARSAASRARARSERSRERASASZASAAAAERARSSASERAAS ZS 


«if 


a en 4 HR RR HH HH FH HH wR HR 


f/x Retrieve the Layer Instance Common Ar2a pointer */ mS 
/x 0D CASE on nessage type */ Ne ae 
/x CASE An IOLD request message */ 
/* Call common routine to transfer LCBI to LACS from [OLD msQ */ 
/* uocate LOLDs counter for tx for statistics */ , 
fx SHOULD 3€ RECEIVING AND CHECKING AN ERROR CODE HERE «f 
ge CASE Tne request to OMA a LCSI to the LACS Aas returned */ 
f/x update LC38 to lac tx counter for statistics */ 
f/x Call procedure to interpret new LCSI xf 
/* SHOULD 3E RECEIVING AND CHECKING AN ERROR CODE HERE x f 
/«x CASE The request to DYA a buffer descristor to tha LACS has reaturnad *«/ 
f/x Call routing to fetch aata suffer from LSd xf 
f/x SHOULD 3E RECEIVING AND CHECKING AN ERROR CODE HERE * / 
f/x CASE The requast to DMA a buffer to the LACS Nas returned */ 
/* update 3UF to Lac tx counter for statistics */ 
f/x Call routine to create LLC PBU and deliver to the MAC Layer a / 
f/x SHOULD SE RECEIVING AND CHECKING AN ERROR CODE HERE « f 
Sx CASE The LACS Network Layer nas a Data Wequest for LLC */ 
f/x Call routina to create LLC PDYU and sceliver to the MAC Layer xf 
f/x SHOULD JE RECEIVING AND CHECKING AN ERROR CODE HERE xf 
Jx CASE The request to OMA a LCBI to tne LS has returned */ 


/* Call procedure to tarminate LC3I and free all memory x f 
/~* update LC3 to L& tx counter for statistics */ 
4/* SHOULD THIS JUST 3E “return_lLcbi™ procedure call x f 


/* SHOULD BE RECEIVING AND CHECKING AN ERROR CUDE HERE * f 
fx CASE Tne MAC data request nas returned as 
an error or a confirm error * A 
* Call procedure to handle error and free all memory * Ne 
* SHOULD 3E RECEIVING AND CHECKING AN ERQIR CODE HERE * 
xf | 
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Se OTHERWISE */ 
FASE EERERESSBRASESPERABRAASESESERAESE SEES ER SESE SESS SASSER ESO ESS 
* Tne messajze can not de setcodes into any that are expactec cy this 
* process. | 
* At this stages tne soace used cy the 
ke messajge 1S returned to tne kernel 
* until a method is designed to hanacle the proolem. 
i> eSSRSESRaAaSZSOSES REO ERERARSSLSaRELALSELASASRSSASERABRREREARS AAS LES A EES @ | 
wf 
fx ENOCASE End of tne message type decoding */ 
} fe switch */ 
Z f/x (leo tx «/ 
[RRR RRR KKK RRR KK KEKE KEKRKEKRKREKKK KKK KK HEKK KKK KEKE KEKE / 
{[R: RES SAe ASS SSS Sees ae eee ease MS SAOUS. Later tac oe Seas sss ar eee a See= a7 
/x Tre request to d¥4 4g LOSI from the 1.6 to the LaCS has returned */ 
jx 


* bie Oe Mee INTERPRET TRANSMIT LOS FEQVESTS PAQCEOURSZ 

® FUNCTION: Receives all O#“A confirn messases sue to tne comoletion 
x 9f a transfer of a LOST to the LACS memory. This 

« routine determires if any otner transfers ara required 
* to fetch the data associated with the request. whan 

* *he data is contained in tne LOSsr this orocedure 

* fetcnes a suffer ta treansfer the data to MACs attaches 
( a LLo header and issues a data request to MAC. 

os Qtnerwise a request 1S mace to transfer the sata ouffer 
* or the ouffer acescriator to the LACS. 

® 

as INPUT? Pointer to message 

* pointer to the layer instance tadsle 

> d 

* OUTPUT: 

bg 


WK REE HR RK KR KR RHR KKK KER KKK RK KEKE KKK KKKEKKKRKKKKKKRKKER 


xf 


FAECES ERESEELSESSSASSALSESESSESLAESE ESS RESAESLESASESESESESLEASRS ESR ESESE S 
* ThIS message? Aas Sean returned from OMA servicese The following 
* code will check the results of the transfer request and if it was 
*« successful. 
‘eee eRe ESRERSESRRaRARBEEAABARRASALASLRSASRABRARALRAAASASBALASRSSSESAS SARA SSL SE & 2 
xf 
f/* IF the request was successful */ 
f/x THEN */ 
f/x DO CASE on the function specific function code xf 
f/x CASE of Connectionless Transmit request a / 
f/x 0O CASE on the tyse af data ouffer in Ltal x«/ 
/* CASE of data ouffer containea in the LCé wf 
/* Fetch a Suffer to move the data to MAC xf 
/* Set the total range «/ 
f/x Get a suffer tnat is the reaquestec 
Lensth + 4 bytes for headers */ 
/* allocate extra head 32 oytes ana tail 125 oytes */ 
/*x space for MAC handle snail buffer Me. Lu */ 


Seo 19 


347249 198 


J 


1 
/* 
fr 
/ 


4 t 
/x* 


J/* 


' ie 
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{x Reduce the outfer size oy 4 bytes for DMA w/ 

/*® anc extra nA2eader space for nac continuuous auffar «/ 
fx here secause the old cxernel not garantee return 

new ouffer discrioter x/ 

/x $23 we keen usin; the ola one. 

met Legal for the new «kernel M. Lu */ 

{x now loads in the aata to buffer */ 

f/x reserved sogace for data in tenon */ 

f/x Clear all ramaining fields */ 
f/x Format it as a LtlLt unnumbered information frane */ 


/x* Issue it 38s a MAC aata resuest «/ 

f/x Comolete the LCO3I status ana comoletion word «f 

f/x Issue mnessaze to the DMA «f 

f/x sat tne reas crecit count for Leo user flow control */ 
f/x Sat the LCSI completion ait af 


/* Raturn the LOSI to Lé& memory */ 
CASE of data buffer pointer(s) contained in the .C3i «/ 
AEE SPESERESEERAELESESARSELSARSER EPA SRLS SE RSE RES LEASES EER SES ARSE SSE SB 
* Wnen the suffer pointer is In tne LC3I, the buffer 
xk containing the messag2? must Se transfered across from the Ls 
* to LACS ouffer memory. Space is allocated for the message and 
* ag raquest suomitted to DMA services to make the move 
TRH KH KKH KERR RE RK KEKE MERE AK KRRKRERKEKEKEKRKKEKKKEKKRREKKKKKK & 
x f 
/* Raquest the buffer oe transferred fron the LE */ . 
f/x Have che message return to the IMA Aone mailbox */ \ 
f/* Sat priority to rormal */ ; 
fe Sat the numoer of L4S suffers « f 
/* Initiatlize total range to zere xf 
fx DO FOR all buffers tn the LCal | « f 
fx Set the LS suffer descriotors */ | 
/x Set the £6 buffer rance */ 
MEER SCEESESESSEESASRALESESSECLASE RASS ESAS ECS SSOP SSAC ESSE SESE SSR SES 


*« There 18 3 proclem 1f the total range exceeds 32K words 


* fortunataly LC will always oe less 3uUT 
te DO we NEED TS VALIDATE RANGE ane 
* WHAT ASOUT LCOS FIURMAT 7 (32 or 14 bits) 
* ana WHAT A20UT LCo FORMAT —- short now 
RHR MK RHR RK ERK KK RK KEKE KKREREKKAERKEKKEKRKAKRKKKKEK 

af 

f/x Set the total range */ 

/* ENDDO nf 

} / fe switcn */ 


set a buffer that is the reguested 
Length + 4 bytes for headers e/ 
allocate extra head Zc bytes ana tail 128 bytes */ 
space for MAC hanale smalt ouffer M. Lu */ 
Reduce the ouffer size oy 4&4 bytes for DMA */ 
ana extra header space for mac continguous duffear x/ 
her? pecause the old kernel | 
not garantee return new Suffer discrioter “4 ys 
SO we keeDd using the old one | ee 
not legal for the new “kernel Me. Lu */ 
Clear all remainins fields */ 
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C 


/* Send the request messac2e to SOYA sarvices */ 
f/* ssecial routine for Lle_trans ratlease */ 

} f/x else vf Full */ 3 
/* CASE of 3a suffer idescriotor psinter caontaines in the LO3I «7 
LK KK RK KKK RK KKK RKK KEKE REKKKEKKKKKEKK 

« wher 3 outfer cescripotor sointer is in the LCEI, thea suffer 
d2scriotor must se transfered across from the LS 
to LACS suffer memory. Space is allocated for the messace and 
a request suomitted te DYA services to make the move. 


sh Re HR 


Tnis 18 identical to the LCS transfer performea sy the ILOLDs 
* ofocedcure. 
Tee RBaEESERERAASDS SERRE ARAARAARSAAABRSRESBSSRASSERSAaSARAESRARABDRARAAESA SSE ® 
«| , 
/* Raecuest tne puffer be transferrad from thea L& */ 
/* Set invalid status in the LCSi / 
fx set the write cresit count for feo user flow control */ 
f/x Set tne LESI completion bit wf 
/* Return the LOII to Lé memory «/ 
{xe OTHERWISE */ 
LHR RH RK RRR KKK KREMER EKER KEKKKEKKKKEKKKKRKEKKKKK 
x Can not decode the ouffer type into anything 
x that can 9e processed by this function. Update the LCS! 
* status to reflect the proolem and return the LC3I to 


( x the Lo. 
ES TR2RaSEPRAERSERALSBRESRSERARABREABDRASLERARLRARSL ARABS SSR SLEA SEARS SR SESS RAR SS ®& 3 
« f/f 
/* Sat invalia status in the LCSI «/ 
f/x set tne write credit count for leo user flow control */ 
f/x Seat the LeBiI completion bit ef 
f/x Return the LlaiI to Ld memory *«/ 
/x ENDCASE x/ 
} f/x switch *«/ 
fe OTHERWISE */ 
/* Inly a connectionless transmit request is currently susported */ 
‘At ESEeSRERESERERASZESESERSSPALASESSESESESRESE RSA EE SSE LEE LASERS RS SS 
*& . 
« Can not decode the requested function into anything 

* that can be o9roceassed oy this function. update the Lisi 

* Status to reflect the proolem ana return the LO3I to 

x the L6. , 

-2 OSE SRERSERESSAALERSRSASS EERE SZSESSLARSRELRALRARLT RS ERA L ES RA AAS SE RSLS SS 
x / 

f/x Set tnvalid status tn the LC3I x«/ 

f/x set the write creait count for lcd user flow control *«/ 
/*x Set the LC3I completion dit td 
/* Return tne LCSI to LS memory */ 

fx ENDCASE x/ 


} fe switch */ 
: fe ELSE x*/ 
er f/x Set invalid status in the LCsI */ 
( /x Try to uadate status in LC3 ana free memory or something */ 


fe ENDIF #/ 
} f/x xmit_teosi_to_lac */ 
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LHR RK RR KK CHK KH K KK KKK REM EK EK KKK KKEKKKEKE KEKE Hw KKK KR EK / 

[ek S22 esseer= SS > >> Sree eee ees Nese ous. LO cer Tack Ssh ese Sessa er SS SSeS Se — x 
fx The LLOATA.request transaction has returned fromm tne LLOE Layer as a 

* L_ DATA.cCOnNfirm. The ouffer and message memory must be released. 

© 

WHR KR KRM KHMER KHER KKH KK RRR HHH RRR KEK ERE RE KREKREKKEKKMEKKKREK 


«f 


x This message is the returning MAC_conf or MAC error. 
* Release the buffer space * 
* Return tne MAC message to L4C3 memory * 

« f | 


FRE RERAESESESESZESLSEAEEREBDESESESEALASEEEARASESESESEREASSASESEAESESSESSESESSL ELSI S i 
/*x Tne request to OMA a data buffer from the Lo to the LACS has returned */ 
/* | 


* et hRRA He HH KR HR RH H HAR 


* TITLE: ISSUE MAC JATA REQUESTS FPROCEDURE 
FUNCTION: TRiS routine is invoked when a buffer is available 
to pe ssueq to MAC as an LLC PDL. ChecKxs are made 
to make? sure that the Layer instance and the LSA? are 
in tne INUSE state. ALL validation of the r2quest 
1s performecs such as ?DU narameterss Local PDdDY Linits 
rencte LSAP Limits and parameeterss etc. A LLC 
header for an unnumbered I frane 1s apaended to the 
suffer and passed to the MAC Layer maopead to this Layer 
layer instance. The LCSI ts tnen marked comoaletead and 
the OMA firmware 1s requested to transfer it back to 
the Ls. 
INPUT: Pointer to message 
pointer to tne layer instance taoale 
OUTPUT: 
* The request to DMA a suffer from the LS has returned * 
(See REE SSE RARER ERSRSaERSSE RARE SS AASSALAASSRASSAAS ERASERS ESE SESS ELER ELSE RASA SA2LE SSE LE SE 
xf 
LM HMM HH MK HH RH HR KHK RRK KKK KKEKKAKRERKEKKKEKRKKKEKK KEK 
«* 


*« This message is returned oy DMA services when it completes the 
* transfer of a ouffer from the L656 to the LACS poara as oart of a 
* transmit transaction. This step will ada tne LLC Layer addressing 


x to the message and send the Ledu to MAC for transmission. 
ieee EP RaEESROaAAALZAARE REE SREREASOSSLZAERSaRERARASEALRSELESERERSRSALESRRAS AS 


x / 
f/* Clear an error flag | wf 
/* Validate that the transfer was succesful « / 


fx IF the transfer was not a success */ 
f/x Set thea state of tne LSAP ana Layer [Instance accordingly */ 
/x set LC3I status woras xf 
/e set the write credit count for Lcd user flow control «/ 
f/x set the LOS status to completed «/ 


{* 
/* 
[* 


3€9 12 Oe: 
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Return the LOSI to LS nenory */ 
Regort a OYA failure */ 
Set @rror cojgae */ 


fe ELSE every tnin3g 1S honky~ 35ry af 
f/x Set a pointer to the Local ana remote 


Lsae tables inte transaction OLk. */ 


f/x M3sking MS lo Sits of leg 


acdar.is restrictive sut mignt save some grief *«/ 


7x Cail procedure to validate the sata reagquest « f 


/* set the writ? creatit count for les user flow control «/ 
f/x set error code */ 
/* Set status In the LOI xf 


/* Call procedure to transfer completas LC3I «ff 


/« Fetch tne adaress of tne Local taole 

from the Lay2r tnstanca local LSAP directory */ 
f/x Fetch the asaress of the remote taole 

from the activate directory of the LSAP x«/ 

f/x ucoata JI_tx counter for statistics */ 


4x Call soroceaure to creat? POU and Issue It to MAC «f 
f/x TF no errors nave beer detected yet xf 

IPRS ERESESBESASASESAEASEESASASEEAESESSASEEERASSERSESESSESESSEASE SES SS ES: 

{* THEN 

« 

* Uodate Local SA? statistics 


WRK RRR REC RMKRHKREKRKCWE KEKE KAEKRKERKEKKEKREKREKRKKKEKKEKKKKE KE 


xf | 
/e Update Layer Instance statistics «ef | 
/* TOE CORE RSSERERERAEASSLAESERE REBEL RLSASESRSAEASESESESASSS ROSES E SOSA SE 
* IF Remote SAP Statistic flags tndicate to always collect 
* statistics or only if Local SAP indicates to 
* collect it on the remote | 
Tao eRARERERESSBERSOBRASRAAERSREASRALRSOAERASLABRABRSARSEREASASASALASSA SSAA S AAAS S : 
« / 
/* THEN */ 
/*x Uocate renote SAP statistics xf 
f/*« ENOIF xf 
/x set the write credit count for leo user flow control */ 
/*« Set status in the LCS3I «/ 
f/x Cali orocedure to transfer completed LC3I « f 
f/x ELSE Error * f 
/* 


/* 


set the write credit count for leo user flow control «/ 
and error xf | 


/* Return tne LCSI to LS memory */ 
fe ENDIF xf 
f/x ENDIF «/ 


ASE ESBESESESSESESCESSESESCSESSSESS&LSSA SS REELS ELSES ALCSES ESS SES LES LSE ELE LES SL SS EES 


Lk SAS eess S33 See S=—-3= SaaS Meysous INterlsCe. SSeS ea tees s Ss res oe 
/« Validate a LLC transmit data request procedure 


dg 


( TITLE: VALIDATE LLC DATA REQUESTS PROCEDURE 
® 
® 


FUNCTION: This routine is invoxed when a buffer is available 
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[Oo b2 Yssuec to MAC 45S an LiLE PDUR. Checks are made 

to mak2 sure tnat the Layer instance anc tne LSA? are 
in tne INUSE state. All valication of tha request 

is performe2ar such as 2DU parameters, Local 20 Linics 
remote LSAP Limits and carameetearss ett. ; 


INPUT: | >ointer to transactiran oslock 
pointer to the layer instance taole 


QUTPUT?: 


RH AHR RHR RR HH HR 


ree eRERSRERSEREBSERSRASZALRARAALLRARESASSRSARRARSRSARARAARZASRSAEASRARALSARA RASS ASSL SE S 


«| 


Je Clear an error fl3g xf 
{x Validate the Logical adarass of the remote and Local sAPS */ 
f/x IF the local log. SAP aadr. is greater than the local LSA? dir. size */ 
/x« Report a failure */ 
/* Set arror code */ 
f/x ENDIF */ 
/x IF the remote lLagical SA acdor. 
is greater than the remote LSAP dir.sz. */ 
f/* Reoort a failure */ 
/x Set error code */ 
f/x ENDIF «/ 
/x Valiagat? the state of tne Layer instance xf 
f/x TF the layer instance 18 not tn tne INUSE state */ 
/* Set tne state of tne LSA? anc Layer Instance accordinaly */ 
/* Set LCdI status words af 
/* Report a f3ilure */ 
/x Set error code */ 
f/x ENDIF x«/ : 
/x Validate that the local SAP exists xf 
f/x TF the Local LSAP dses not exist */ 
f/« Set tne state of the LSA® anc Layer Instance accordingly */ 
f/x Set LCsi status words xf 
f/x Report a LSAP failura */ 
/* Set error code x*/ 
4x ENDIF x/ 
/x Validate the stat2 of the tLocat LSAP xf 
PRE RH KRK KRKKRRKEERERKERRREREERE KKK EKRKRKEKEKEKEKKKKKKKKEKKKKKKKKKKK KKK 


Je T3 THERE A PROBLEM HERE TF THIS CODE [5 EXECUTES EVEN THOUGH 


& SAP IS NONTEXISTENT 

. access undefined memory 

= - Dus error 
-eSeeERRAEaRSESSEAALRESERESRAZSAE AS ALaSZERAARASLASREBRARALZASALEASSRSE LES SESSA S | 
«/ 


f/x IF the major state of the LSAP is not INUSE xf 
f/x Set the state af the LSAP and Layer Instance accordingly «/ 
fe Set LCs status words xf 
f/x Regort a LSAP failure x/ 
/* Set error code */ 
/* ENDIF «/ 
f/x Valicate that tne LSA? Limits are not exceeded «/ 
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J/=« IF the POU size exceeds the naximum PSU siz2 wf 
fx Set tne state of the it $4? ana Layer Instance accordingly */ 
f/x Set LOSI status words «/ 


/*® Report a 270U failure x«/ 
fx Sat error coae rf 
/e ENDIF ¥/ 
/« Validate the Remote LSA? wf 
‘x TF the Remote SAP 15 Not active” */ 
f/x Sat the state of the LSAP and Layer Instance accordingly *«/ 
f/x Set LC3i status woras xf 
/* Regort a LSAP failure x*/ 
f/x Set error code *«/ 
fx ENDIF */ 
f/x Just watcn now */ 
f/x Return with error code «f 
} /e validate_data_req ¥*/ 


[KR ie HR KK KERR RK KK REKE KK KKK KEK KKKKKKKEKKKEKKKKKKR EK / 


[x Sa seSoe= rte ar aaron LLG ‘SAP (Lomsonent =S2SsseeeseseSsseen> £7 
{* 


® TLILes FORMAT UI LLC PDU PROCEDURE 


FUNCTION: Receives a transaction block containins a pointer toa 
a ouffer of data. The source and gestination area 
ar2 gades to tne LLC header and the unnumd2red 
control header is added. A 4AC aata rpecuest messaje 
is preogred and issued to tne MAC transmit crocess 
mailooxe 

IN®?UT: Pointer to LLC transaction block 
Potinter to Layer instance tansle 


OL TPUT: Sreror Cote 


WRC MRK MRR RR KR KR ERE KREME RK RMR KKK KR RK KK EKER ERK RERAEKEKKKEKKKK KK 
«/ 
IRE AESEEESEESEAREEESESESRSESAESESIESEELSEROASEEAESAESAEEESSE CESSES EST TEST: 
x« Tne wessage 13 a LLCO transaction olock conplete with vointers to th2 
* the Local LULSAP tabler tn? remote LSA? taoler, tne LOSI and the suffer. 
WRK K RK RRR KK KKK KK KKK RKRKKKRK ERK RK KE RK RRR KKK KEK KEK RK 
«f/f 
/x Allocate memory for a MAC data request message */ 
/* Set the messaje type into a MAC CATA. requast */ 
/x Set the priority «f/f 
f/x Set the return mailoox ID */ 
f/x SHOULD THIS BE NULLED 2777*/ 
f/x / 727297 mac _dreq_msg->return_id = lLica_pw~>xmit_mbxs, */ 


/x* Add 3 bytes of LLC address to the segining of the Ouffer */ 
/* for LLC header - what asout MAC */ 
( f/x Add the LLC addressing (remote and Local SAPs) to the POU oUuffer */ 
i. = Je Use a type I unnumbered I-frame command */ 
f/x S2t the class of service into tne message «/ 
/x Move the aestination MAC aceress into the mnessagje */ 


3e0 19 
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NeED TO TALK ABOUT THIS _~ wOULLDdD COPY 3UFFER WORK JETTER xf 

set the message ouffer aescriotor address to osint to tne Lilt POY *x/ 
Sena the transaction to “AC for transmission */ 

/x free tne message */ 

/x upcate messaye droosed counter */ 

/x free the messaje */ 

Je els2 if M3Xfull */ 

Retuf" xf 

/* 18S _mac_dreq */ 


ff 
he 


nee at 
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/ 
* This file Chlle_const.h) gefines tne constants used in the LLC 
* Layar orocesses for the LACS coarcd. 

bd 


f/x Dafine commanass next fr 2ads next receivass poll-final Sit masks */ 
‘x for LLC frames. (3se92 struct Lle_frames) */ 


f/x Suoervisory frames */ 
f/x Supervisory oit */ 
/* Receiver Yeady command «/ 
f/x Reject command «/ 
f/x Racaiver Not Ready */ 
{x Poll-Final */ 
/x Naxt Received count */ 


f/x Information frames */ 

/x Information ait */ 

/« Next Sena count «/ 

f/« Poll-Final */ 

fr Nore OXF=O0 Next Received count «/ 


f/x Unnumberes Frames */ 
f/x Unnumbered oits */ 
f/x Set Asyne Sal Moce Ext e/ 
f/x Disconnect */ 
f/x Unnumderec Acknowledge */ 
{/* Disconnect Mode */ 
/* Frame Reject *«/# 
Jx Excnange ID P bit clear */ 
f/x Exchange ID P ait set */ 
f/x T2st command P cit clear */ 
f/x Tast command P sit set */ 
/« PoltrFinal */ 


/x Length of UI POY deacer */ 


f/x adc special for mac Layer s2nqa small packages oreagllocate neader 32 bytes */ 
fe Me. Lu 2/35 «f/ 
/* 123 oytes more tail for mac */ 


/* sit masks for words tn the LC3I memory block (See struct lLedi_mblx) */ 


f/x Tne interruot control word (cotcw) */ 
fe 371ts O-/7 Channel */ 
Je 31ts 847 CPU xf 
fx sits 10-15 Intr level x/ 


/x The function coage word (Ccdofsfd *«/ 
f/x 31t mask for function codes */ | 
Cc /* Values that may appear in the function code fields */ 
L-~ ¢*& Connectionless Receive function code */ 
/x fonnectionless Transmit function code «/ 
fe event function code */ 


/* 


{/* 


[in 
jx 
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f/x Activate tocal function cote x/ 

/* Activate ramote function code x«/ 
f/« Deactivate Local function coge */ 
f/x Jaactivate remste function code / 


J/« Activate for local or renoctre function code «/ 


The controller status word (cocts) */ 
/* invalia function code */ 

fx RAM memory exhaust */ 

/* RAM Location non-existent *«/ 

fx RAM parity error */ 

/* £6 memory yellow */ 

/* Nonwmexistent LS memory */ 

f/x i6 ous Oarity error */ 

f/x LE memory red «/ 


Tae function specific status word (cerfss) *«/ 

f* SAP not active */ 

/« Lack of resources x/ 

fe Controller unavailable «*/ 

f/* SM error x/ | 

fe SAP already active */ 

f/x Undefined */ 

/* SA? already seactiv3ated */ a 
f/x Receive suffer too smatl */ he 
f/« [llegal Logical adaress */ 

/*e Invalia i.Cs */ 

f/x Write credit violation x/ 

/* 2ead creait violation */ 


Tne comoletion word Ccdcos) x/ 
f/x Completion bit *x/ 
f/x LC3 not orocesseda */ 


sit masks for tna IOLI command word */ 


The “rang? wora”" x/ 
{x Function cade */ 
/« Length in sytes e/ 


The "Channel Number or Layer Instance Numoer”™ x / 
f/x Controller address «/ 

/*x Layer numper */ 

/~« Layer instance */ 


Index values for the Function Directory Mailbox array */ 
See struct lLicas element fc_mbxf16J] */ 


/« Receive x/ 

f/x Transmit */ o™ 

f/x Event «/ oY 
” edasele 

f/x Activate */ 

fe OQeactivate */ 
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- 
fe Data duffer typa sefinitians m7, NEED TO CUORIINATE wiTd Lo 


/* Jata suffer pointer(s) in tne LOB) */ 
fe ALL cata contained tin the LOS *«/ 
/* Suffer Ddescricstor potnter tin the ctl «fs 


/* CSAP Taola indicator flag cefinitions --- */ 
f/x Activate remote saps dynamically «/ 


/®* no more reas credits can acceasted «/ 
/* cac Leb set uo ait */ 
f/x «_.Cai conpletion status */ 


fx LLt Layer Numoer «/ 
f* LLE Layer number 15 equal to 2 «/ 
f/x Tne definition of ‘instance numders! «/ 
/*x Tne conditions under which messages age out are defined here *x/ 


f/x Alarm cerioa */ 
f/*« Avpout 3 ninutes */ 


@ Maximum cGirectory sizes xf 

one /* §4 for tine 5eIng xf 
fx until a oatter suggestion xf 
/* who knows when x/ 


f/x States for Local LSASs x/ 
fx Active state */ 

f/« Inactilive status */ 

/x MAC error code x/ 


x ERRORS and success xf 
f/x success A 


{/* 3Ad function spec. function code */ 
/x Invalid function coje «/ 
/x Sad layer instance state x/ 
/x Bad or unknown remote SAP x«/ 
/*« Sad or unknown tlocal SA? */ 
f/x SAP already active « / 
/x SAP deactivated wf 
/x Multiole activate requests on SAP */ 
/x Bad remote SAP state x*/ 
{x 3gad local SAP state «/ 
/x creat? local lsap error */ 
/x creat? remote lsao 2rror x/ 
c /* SAP not available for services */ 
i f/x Bad DSAP in received F0U) «/ 
f/x Gad SSAP in received PdDU) x/ 
f/x Baa DYA transfer of data ouffer = x/ 


[* 
3 
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/x stad OMA transfer of ouffer cesc. */ 

f/x maa transmit recuest casce *f/ 

/* Saag POU size «f/f 
LC& puffer size too snall for PIU «/ 
33a DSA? state e/ 

PU exceeds max PIU Size *K/ 
recieve transmit queue full */ 
Invalia transfer */ 

raturn Lceoi error */ 

ead lcdi response - bij err k/ 

fe incrrect venue value *«/ 
cata too Long for sata in Les */ 

/x DMA of a suffer failed «/ 
bad register mail Sox directory */ 
Pac receives PbU) xf 
invalia SM request */ 

f/x xid transaction error */ 

f/x xid respound error «/ 
UNKNOWN message typ2 *«/ 
9a9. 190 message */ 
invalid S4 return mail sox */ 

34 return mailoox full «/ 
invalid DWA mail sox */ 
DMA return mailbdox full «/ 

/x invalid MAC mail box */ 
Mac raturn mailcox full */ 
genaric default error «/ 

/* getouf could not allocate */ 

4x allocate no mem avail */ 

/e resolve nail oox failed */ 

/* registe mail sox failed *«/ 
mail box turn on faileac */ 

f/x mail box turn off failed */ 
matt box delete failed */ 

Send massege failed */ 
f/x ile Layer event code */ 


/* No matcn aon a searcn aciaress or name rf 
/*x for error but not axit returns cto calling */ 
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IBLE EEERERREREAEBESAE SESE ASASRESSESSESESRESSEERESERESE SE SERS SSAS ESE SS S 
* 


x This file Clle_structen) define the structures used in tne 
* cLC Layer orccesses for the LACS coarcad. 
af 


f/x Satine a structure for LLCO frames «/ 
fw KK RR RRR KKK KE RE KKK KERR EKEKKEKKKEK KK ERK KEK / 


f/x Structure for Suparvisory commands */ 
fe Structure for unnumoered commands */ 
f/x Seructure for dtatarmining PIL type */ 
/x Define a structure used to engueue Lle_trans on a LSAP taole */ 
/x Dafine a structure for LOSI memory olocks */ 
/x fead LC3 information wf 
/x write LC3 Infornation w / 
/* Data Arrival event information *«/ 
/* Additional write credits event information */ 
fw SAP Error avent */ 
/x Defina a structur2 for 3a ouffer descriptor Image xf 
f/x Lefine a structure for remote LSAP tadles */ 
fe NeZ=ed TO REORDER FOR STANDARDIZATION x / 
4 
Sit GO —- Maintain Stats on all requests 
. 3it 3 - Maintain Stats if Local match 
{. 34015 - Dynamic RSAP 
A ’ xf 
fe THE FOLLOWING STATS FOR REMCTES MUST SE REVISITED « f 
f/x Dafine a structure for a remote LSAP directory */ 
4x NED TO REEXAMINE FOR CORRECTNESS «/ 
/x Defin2 a structure for tocal LSAP tables */ | 
fe N=ED TO RECRDER FUR STANDARDIZATION xf 
/* 
31t J - Maintain Stats on this L3A?P 


31t % - Maintain Stats on Remotes 
31t15 ~- Mejaous Exposea LSAP 

[* 
33t J - ReOOort Data Arrival 
sit 1 - Report write Credits - N/A 
Bit 2 —~ LSAP éErrors 

xf 

/x Define a structur2 for a Local LSAP directory */ 
S* NEED TO REEXAMINE FOR CORRECTNESS wf 


f/x A structure for tne LLC Instance Common Area *x/ 

/«* Mailpnox Ids used dy the LLC layer */ 

/x* Local LSAP directory pointers */ 

/* Remote LSAP directory pointers x/ 

/x Layer emergency event message ptr */ 

f/x Remote LSAP event counters */ 

f/x Layer Instance Parameters */ 
{* (ee BSE RSLE SE SAS ASRSEARSLALRAASRSASE SRS ERSeRZRABRASARARSASAZARSARERSAAAALSSRAAA ALS SS SB 3 
Cs layer transaction structure. The too of this structure 15 
, va union of several messajze types used in the processing of a transaction. 
* Pointers to other memory dSlocks are carried along with the transaction 
* to reduce the decoding ana tadle Lookup that would otherwise oe required. 
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(See ee eee RESEEARSARASLESS AREAS RS RERSSRARRSESEASASRASSARARAEASRASAASRAL SES ARASEL SS 


/ 


Je extern (lacs_cs1) LACS software crash error Log reserved tocation */ 


frowwrocrcrecrr-= —_<an an a> a OO enePene 2@ we ama e we wees @ 


/* Lle tLayer 0 error message 
f/x extern ile LAYER 1 reserved clock 
f/x (lke tLayer 1 error massage 
fe axtern Lhe LAYER 2 reserved olock 
f/x tle Layer 2 error message 
fe extarn Lic LAYER 3 reserved slock 
/* ile layer 3 error messaje 


on i ne nn ee / 


Stack xf 
xf | 
Stack */ 
* / 

Stack */ 
af 

Stack *«/ 
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oa 


fe Tnis file Cllcinclusesen) is the master incluae file for LLC Layer 
* orocesses. The header files usec are listed below. 

x / 

f/x Include all kernel neader files */ 

f/x Include alt LACS nessage definitions */ 

{x Include all Station Management header files «/ 

/* Include all megadus header files */ 

f/* Include all mac header files */ 

Je Include atl LLC Layer macros */ 


f/x Include alt LLC Layer constants */ 


fx Include atl LLC Layar structures x/ 


3e9 1% 
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| HHI II Ke He HK ER KEK RK EKER ERK EE KEK KKEKEKKEK KEKE 
RK KR KK RR RK KKK ERK KKK KEK KEEKEKREKEK KEK 
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MINEY WELL 
Local Area Network 


L LIN XK C9 a 7. ee 


rc 
© 
a? 
4 
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mac layer interface mogul 


Cooyrishts Honeywell Information Systen 
ALL rights reserved. 


Cereat? date: 5/254/25 
sy: Me Lu 
Discriotion: 


Functions & Paraneters: 


Revisi IN 43 

Dates - 
Sy: 

Discription: 


Revision #s 
date: 

Sys 
Discriotion: 


tee eee eae ERE RASA RS EASA RARRARRARE SRA RARARSRASA SER ERARAAARS SEES ARS SL ASSL 2S 
(222 Bee eee eRe SSS eR RSS ee ee RRERRRaSRERSaSA SEES REARS AR SAS ASAASL ASRS AALS SS 1 


xf 


[KKH RH HK HK RHEE KR EK KK REKKEKRERKEKKKEKEREKKKREKKREKR AK KKREKRKEKRKKK f 


ix 


* 


aA AR HH HH HF 


ELTGs% SEND ACTIVATE MESSAGE TO MAC LAYER PROTEDURE 


FUNCTION: All mailooxes are turned off until the MAC 
activate message is returned. This 18 to srevent 
anunber of MAC activate reasuests bDeIn3 sent due 
to multiole activates received. A special ¥AC 
Activate mailoox ts created to return the messace 
frrom MAC. The activate message is sent to tha 
MAC Layer nanager and the LLO Activate message is 
sent back to the LLC mailbox. 


~ 
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INOUTS Pointer to layer instance tasla 


x 
sd 
€ 
x 
* 
« 


LAPEER RELLE RSE RRARABRSEEAESERASLESERASE AL ASRERARE SAAR ARARALRARSLSE AS ALS SAS SS 


xf 


JUTPUT: 


/« Create ana Store 
MAC registration mailbox to 92 used for a one time messazer/ 
f/x seat Limit to one messace osefore full */ 


f/x Allocate some spaca for a MAC query message *«/ 
/x« DO CASE on the Layer Itnstanc2a nunber of 
/x CASE Instance J *«/ 


fx Set MAC mailoox ID for Layer instance J) */ 


fe SASE Instance 1 xf 
Je get MAC mailoox [D0 for Layer instanc? 1 «/ 


fe CASE Instance 2? */ 
/*« Get MAC mailoox ID for Layer instance 2 «/ 


/*x CASE Instance $3 t/ 
f/* get MAC maildox ID for Layer instance 3 «/ 


fx STHERWISE wf - | 
/x Jnknown Instance numoers fatal error */ 
f/x ENDCASE *«/ 
> /ex saitchn «/ 
f/x Sena message to WAC Layer manager «f 
f/x Jeclare the nessag2 tyoe to be ‘mac activate! */ 
/~« Set the oriority and clear the Suffer descriotors */ 
f/x FILL in mailsox for IJATA.Indicate messages */ 
/« Clear the returning maildsox IDs */ 
/~ Declare the return maildoox */ 


/*x Send the MAC query message */ 


f/x Return xf 
} /* mac_activate *«/ 


ee ee 
, Oa ee we Tee ee ee a ee — oo a wa oe —_ =» ii<¢ Layer Mana Jement 1 On oD On 0 ee Oe ee 8 oe we ee OO Oe eee wf 


* TITLE: MAC REGISTRATION COMPLETE PROCEDURE 
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ae 
® | 
*« FUNCTION: The MAC 3ctivate request mnassajye has returnes 
* completes co LLC. A successfully completes reauest 
k contains tne matloox isa for YAS data reaquest mailbox 
« whic ry is Saved in the Layer instanca taole. ALL 
« ILO natlooxes ar@ turned ang the mac recsistration 
" Mailoox 15 deleted. Tre state cof tne Layer instance 
* 1$ s2t to Inwuse States. An unsuccesful completion 
* of tne MAC registration will c3aus? tre state of the 
* Layer instance to de sat to 7777007SASLED??) 
« 
* INPUT: Pointer to message 
* Pointer to LLC common Layer instance table 
x : 
* QUTPUT: 
& 
RecacccsacccseneccncvcceeeltliC Layar Management ccoscnuseccsacscsessenavacac® 
* AAC ACTIVATE_CUOMPLETcCD.request message 
(xe e eo eee RE RE RESERAEESAR ERR RES ESAEA SE RARER SRP SEERA SRAAERERRARASAR AREA ASRRAAA SRSA SE 2S 
xf 
f/x Turn on LLC LYE mailooxas used during normal operations */ 
f/x Delete MAC activate message mailbox xf 
Je IF the registration was a success */ ei 
/*® ELSE xf 


{x ENDIF «/ 
f/x Release tne message dslock to free memory */ 


fe RETIRN wf 
> /*« maclact_caomp */ 


fmm KEKE K KK KKK KK KK RK KK a KKK RR KKK ERE KRKKKKKKKKK KEK KKKK Ee / 
[to SS SaaS ea ee ae ee. SAR COMOONeNt. eee eae ear ees See e/ 
fe A MAC_DATA.INGicate message */ 

/* 

TiTLes PROCESS A MAC DATA INDICATE PROCEDURE 


* 


FUNCTION: A mac data indicate nessage is recieved with 
a ouffer of data tntenced for an LSAP. Tha 
tyoe of POU is determined and processea accordinly. 
For unumoer information framess the LLC header 
information ts striposzei off and delivered to tne 
Network layer or across the MEgadus if a reaa LCO3I 
is availatple. If there is no LOSI available the meassaye 
1S gueud as oart of a transaction olock until one is 
avatlaole. | 


INPUT: Pointer to MAC aata indicate message | ‘ey 
Pointer to Layer Instance conmon table 


eeneneneh te eh HHH HH HD 
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* QIUTPUT: =srror status 
* 


KREMER RK KKK KKK RHR RK KER KK RK RE KH KR KRK RK REE KK EK RAEKKKRKKK KKK 


«/ 


4x Point to the suffer «/ 


f/x DD CASE on the frame tyoe receives | xf 
fe CASE Of Unnumsered information frame «f 
f/x Call onrocedure to validate the ?3U raguest for this SA? 
f* ITF it is a valia POL ef 
/* Then 


f/x Fecch the Local LSAP taclea 
ignore grouo addresses for now */ 


fx increase UI_rx counter */ 


/«x Fetcn the remote lsap taole cf 
/x IF Local LSA? 38 mappea to a LACS network layer «/ 
J*x THEN 


/* Call procedure to strio off LLC header 


/« Create a Lic_aata_indicate message to ve 
delivered to network */ 


f/x Send massage to mailoox in LSA? taole for Networx 
} /e if L_lsano_tbl->net_nbx NULL */ 
fe ELSE IF Megasus interface ana a reaa LOEB is availaols2 


/* Deaequeue the first LEsI x/ 
f/x update the queue counter */ 


xf 


xf 


«/ 


+ / 


«xf 


f/x JO WHILE the LCI does not have a ouffer large enough 


to hola the data or LC&I read queve is not empty 
/* Set status in LCSI ta Indicate buff too small 
Je Set actual size of buffer xf 


/x Lesi ! set the read credit count for 
Leo usar flow control xf 


f/x Set LCS8i completion soit 
f/* Return LCO8I to the L454. 


/* Dequeue the next i.C3I from reac LCBI queue 


« f 
wf 
xf 
«f 
x / 
ef 
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[ee uadate the queue counter */ 
> fx anile xf 
/x IF LC3 suffer{(s) can contain all of POU */ 
/* THEN everything 1s okey coxkey af 
/x Comalet tne LCSI status | xf 
fx S$2t the actual stze */ | 
fx Sat the remote logical address */ 
f/x Leoi_trans~>lLcdi_olk->lebi_tyne.read_tcosi.coira = 
r_lsap_lLogl_aaars*/ 


f/* Strip off LLC header from FDU 


4x Calt procedure to comolet2 remainder 
fe FiK initial nac_inc FFFFF err. Me. Lun 3/36 */ 


} fe if cbotrg */ 


4x ELSE Last LOLI suffer too small and no 
availaote LCOC3S Left on queue *x/ 


f/x Create LLCO transaction block for 270 « f 
Je Allocate some space for a LLc transaction olock x/ 


fx Save a vointer to the MAC indicates 
message in the transe oOlx. */ 


f/x Save the LSAP table pointers ana what else «/ 
/* save renote sap logical adar */ 
/* save local tsas table aadr x/ 
fx save remota lsao taotle aacar */ 
fx Clear the LCSI pointer since tnere is not one known yet */ 


f/x Strip off LLC header from PU and set 
suffer desc tnto transebdl xk */ 


4x Send LC3SI tranaction olock sack to the L6 %/ 

/x Clear the cata Suffer in the transaction wablk */ 

f/* Set actual size of ouffer | «/ 

f/x Set status in LCBI to indicate buff too smail «/ 
fe Lodi set the read cregit count for Leo flow control */ 


/* Set LCSi completion bit ef 
fe RQeturmn LCSI to the L6é «f 
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f/x IF data arrival event is to be 
reogorte2d ano an event (C327 18s Aancy */ 


fe Then x / 


/* Qgeue MAC tncicate transaction aslocx on 
O9du waiting aueus «x / 


/« Fatch and clear event LCBI sointer from 


LSAP table  f 
/* Set buffer size ana event status into LCai x / 
f/x Return LOSI to th Ld « f 


/x Start ageing of message */ 


/* ELSE IF data arrival event is to de 
raoorted sut there 15 not an avant LOEI available */ 


f/x Gueue MAC tinatcate transaction 
alock anto event aata arrival queue *«/ 


/e Start azeinjg of messaqe *«/ 


( f/x ELSE «f 
/* cneck bound Limit */ 
/* over the sound Limits drop the request */ 


f/x uodate the odu sacket drooped */ 
f/x dumo the trans ol« */ 
>} s/ke If DOUNFD LT */ 
f/x uodat2e the queue counter */ 
f/x Queue MAC indicate trans block on to 
o9du waiting queue «f 
> Sse else */ 


fe Clear the aging counter 7772777277 af 
f/x Start aseing of message xf 
f/x ENDIF «f 
+ : f/x if_else cotrg */ 
f« ENOTF & f 
} f/x if_else_if */ 


f/x ELS must de Megaous interface but no outstanding read LC3 */ 


/x* Creat2 LLC transaction slock for PDYU wf 


/x Allocate some Sdace tor a LLOE transaction slock «*/ 


3929 19 


93256 17245 


/* 
[x 


fx 


3 


J * 
i * 


y, 
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Save a oo tnter to the AMAT Indicate 
MeSSat? in the trans. ok. */ 


Save tne L3A?> taale pointers and what else «/ 
Save remote sad Legical acir */ 

fe save Local lsarp taole asar x/ 

/* save2 remote Lsap t3a0l2 accor */ 


Clear the LCSI pointer since there is not one known yet */ 


Stria off LLC reader from DU 
and set suffer dese into transedlk */ 


{F data arrival event 1S to Dde 
reogorted ana an event LC3I is nandy xf 


Then xf 


Queue MAC indicate 
transaction olock on fsdu waiting queue 


Fetch and clear avent 
2C3Il pointer fron ULSAP table x f 


Set ouffer siz22 anc event status into LCBI x/ 


Return Lt3rI to th Lo xf 


Start ageing of message x f 


ELSE IF data arrival event ts to be 
reported out there is not an event LC3I available */ 


Queue MAC inaicate transaction 
SlLocK onto event sata arrival queue */ 


start ageing of message «/ 


rd / 
ck souna Limit «/ 
* Over tre Sound Limits dros the request */ 


f/x update the pdu packet dropped «/ 
/x dumo the trans blk x/ 
{x if «f/f 
/*x update the queue counter */ 
f/x Queue MAC Indicate trans block 
On to ocu waiting queue «f 
/x else ef 


f/x Clear the aging counter 777777777 wf 


/x Start ageing of message «f 


/e ENDIF xf 


«f 
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f/x ENDIF «/ 


fe ELSc an error must Nave occurred xf 
fx WHAT ASQUT STATS xf 


f/x Drop the Incoming oaur the LSAP 15 nor defined */ 


f/x Free the MAC message */ 
Je SNOIIF x«/ 


fe CASe of an Xid 70uU 97 Sit clear case *«/ 


/* CASE of an XID PDU P ait set case wf 
4/x« CASE of a TeST pdu P dit clear case « f 
Fe CASE of a TEST ody © DIt Set case « / 
Je CTHERWISE itmust oe a very vxad PDY xf 
fx =NOCASE x f 
> /*® switch */ 


f/x mac_ind x*/ 
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| Ge 
i 

LRRRKKRKEKRKEKKKERKEKRRKRKEKKK RR KEK KKK KKK RRR KEKKREKREKEKRKEKKREEKKKEKKKKKEK 
weee*K MH RK RK KKK KKK RE KKK KKK KEK KKK KKK KKK EK 
x* . : 
kx 
zk" «€ 
wk & k AUNZYWELL 
wre 
kk % Local Area Network 
eke 
& % Log6ét AL L xr NX C ON TROL 
nt 
rk © iL A Y E R 
exe 
ke & transport ~ network layer 
wk & interface module 
kk & 
KK « 
kk Cooyrights:s Honeywell Infornation System 
tx & ALL rignts reservec. 
wx 
ae Cereate2 Dates 3/25/39 
ke & 3y Me Lu 
kee Discriptions | 
Ke KR a 
ke % Functions %& Parameters: is. 
xx« 
wwe 
kk & Revision As 
kek Date: 

"kk 3y: 
wk & Discriptions 
ek 
«mt Revision #; 
wk & dates; 
ek t sy: 
tt & Discriptions 
ek & 
b > ae 
RSS TESISESOSISCSICSCOOCSCSOOCSSS COSTES SSL SCS LC OLS S SS eT eS ee TS SS Te See Se 2 
‘Pee eaBRRESREZASEEO LE SSRESSARARDLAaAZASARASA AS ARASSLSAEPARS SARL RARAAZESASAAAA SRSA ESE SS | 
cf 
[lxxekkn (2eePRSRERSEERSERALRSDESLERARSRARZALLARSAAERAERESAASRE RS RLS LEELSARA LSS S 3 kekkrkkkzn f 
/* | 
t TITLE: TRANSPORT LAYER INTERFACE ACTIVATE LSAP PROCEDURE 
& 
* FUNCTION: teceives an activate LSAP request message » from tran 
* Local lLsap request cause a search of the local LSAP 
« gSirectory te insure the LSAP exists and the LSAP 
a nas not seen previously activated or in a state | ff ~ 
* orohibiting service to the user. Remote Lsaod requests \ 
* are also checked to insure the LSAP does existe [n 
* additions a pointer to the remote LSAP table 1s placed 
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in the activatea LSAP atractory of the local LSAP. 


INPUT: Potnter to mailbox m2ssaze 
Pointer to layer instance tandle 


x 
* 
* 
® 
* 
* 


OUTPUT: 


->aeaeRe SAE ASRS E AE SRA SERS RARARSARASRSASARABRASRAALSASRABSSASARARALSL ESE SAS ASAR SE Ee 


x f 


fe LLO_TRANS *activate_Lsaps * poirter to create Local lsap messace */ 
[x 

katekeee NEED TO REVISIT THIS IN GRDOER TO SUPFORT eurenane 

akekkee AN ACTIVATE REQUEST FROM A NETWORK LAVER xuwkeee 


« / | 
/x Cast on activate transaction olock message « f 
f/x activata_lsap = CLLOC_TRANS *)moxotrs */ 


f/x IT©& Layer instance state inaicates Lle not registered with 
MAC (state=NULL) */ 


/«x THEN wf 
/x Fetch pointar to Lsap name in ACTVY_MSS xf 
/* Call search procedure to determine if LSAP axists xf 
/* IF LSAP exists in LSAP Girectory and LSAP state is Nulled xf 
J«x THEN xf 
fe Call mac_activate procedure to activate MAC Layer xf 
{ | /* Rewrissue activate message to the Lhke_mailsox xf 
) f/* ELSE LSA? doesn't exist. «xf 
/x Set status of LCBI to tndicate sad LSAP */ 
4x Set completion word in tha LCII x / 
/x Request OMA services to transfer LC3 af 
/* This is one of the gifficult errors to hanale xf 
f/x ENOTF nf 
fe ELSEIF Layer instance is in the INUSE state xf 


f/x DO CASE SN venue to ceternine 
whetner 32 remote or Local LSA? activate */ 
fe CASE of Local venue «/ 
fe ¢€4as2 ACTV_LIC: ¥/ 
f/x Cail orocedure to Activate a Local LSAP for this request x/ 
f/x 3$2t status of LCSI to indicate operation status */ 
Je CASE of Remot? LSAP «/ 
/x cas? ACTV_RMTs */ 
4x Call procedure to Activate 3 
| Remote LSAP for this request */ 
f/« Set status of LC3I to indicate operation status */ 
fe OTHERWISE unknown venue */ 
f/x Can this really haopen and not 
be previously detected ? x f 
f/x Set status of LCSI to 
indicate badq function specific function code */ 


f/x ENDCASE x/ 
| f/x Seat comoletion word in the LCST | wf 
a /e activate _lLsapw~>lesi_blk~>cbcts = LCSI_COMPLETEDs, */ 
( f/x Raquest OMA services to transfer LC3 * / 
/* This 18 one of the difficult errors to handle x / 


f/x Lhkcerr_coae = return_icbitactivate_lsaosvzlica_pr>lme_mbxslica_pds *«/ 
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fo 
NU” 
f/x LSS Layer instanc2? not aslie td susnort reaquest «/ 
f‘«* Set status of LCST to tinagicate layer un3agole to sucgoort raauest e/ 
fx Set comolation wora in the LCST | «f 
/e activate _(saor>lesi_olkw>coccs = LOZT_COMPLETED {| LCORA_ERRF *#/ 
f/x Raguest DMA services to transfer LC3 xf 
[* TAIS 15 One of the difficult errors to hanclea 
/~ Llecerr_code = return_icosicactivate_lsaprvlica_p~>ime_moxslica pds */ 
/*® ENDIF : wf 
f/x Return x/ 
> fe Lhe _trn_ac «/ 
LR KKKRKK EK KK RRR REM KRR RK KKK ERE KEKE KKKKREKKEKKK CK TREK KERKEKEKKEKRKEEKKK cxx«xf 
{« 
® 
* TITLE: ACTIVATE LOCAL LSAP PROCEDURE 
x 
i FUNCTION: Qeceives an activate L35AP request message for 4a 
* Local wSAP. 
€ THe rejuest caus®s a search cf the Local LSA? 
directory to insure the LSAP exists and thea LSAP 
« Nas not se29N previously activated or in a state 
* arohioiting service to the user. 
* 
* INPUT: Pointer to mailbox message 
x Pointer to Layer instanc2 table oS 
* Ue 
tx OUTPUT: 
T<£eP REESE RSA SASSER ARAARSRERSERESeASRRARASZAASASAAASAAZERERSRABEASARLARSARASALASAAA ASS | 
wf e 
f/x Fetch potnter to lsap name tn Leal « f 
f/x Call search procedure to sgetermine tf LSAP exists « f 
/e TF LSAP exists In LSAP Jtrectory and LSAP state is Nulled xf 
f/x THEN xf 
Je Fetch a pointer to tne LSAP tasle * / 
/e 0O CASE on the najor state of the 
/x CAS= JF THE LSAP state is Uuininitialized ¢ 
4x SET LSAP TO A MEGASUS INTERFACE xe 
NEED TO REVISIT FOR NETWORK INTERFACE */ 
/x Set LSA? state to INTUSe and JPerational */ 
f/x Set Logical adcgress into return message or LC3 */ 
fx Set max numoer of bytes in POU */ 
f/x Set read and write creait values into LCS x/ 
fx Set status to incicate successful operation */ 
fx CASE Of LSA? state is already INTUSE */ 
4x Set Logical accress into return message or LCS */ 
f/x Ser max number of bytes in POU «f/f 
/* Set read and write credit values into LC8 x | 
/x Set status to indicate SAP is already activated */ 
fx CASE of LSAP 15 Not available for service CLOCKED/DIWNe- etc.) */ 
f/x Set status to indicate SA? is unavailable */ | —_ 
fx ENDCASE tn 


4 


fe ELSE LSA? is non extstent 
f/« Set status to indicate SAP 75 3a38 


x / 


«/ 
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f/x ENDIF 
fe RETURN | x / 


IRS ROESEREERSESESRSAESESSESELE SASSO SE SSRES ESSERE EERE RSS E SILL ES LSS ESE SELLS RS SE 


jr 


® Viruses ACTIVATE PEMOTE CSAP PROCEDURE 
« 
* FUNCTION: Recetves an activate LSA? request message » 
Activate remot? lLsap requests ar2 made with respect 
x to a local LSAP. ‘The layer instances lLacal LSAP 
® directory 1s checkea ts insure the local LSA? 
* existse If it extsts tnen a check 1S made on the 
J Local LSA activated remote directory te insur? that 
*« tne remote has not been already activated. The 
state of the remote LSAP 13 set to Activated if not 
« already ang a count of the numoer of activates 
* received 1s incremented. Finally 3 pointer 
* to tne remote LSAP tanle is oklacead 
® in tne activated L3SAP directory of tre Local L3ZAP. 
x 
« INPUT: Pointer to mailsox messajye 
€ Pointer to Layer instance tadle 
*® 
a OUTPUT: 
eee ease eae eee ea eee ee ee 
4 
fe if local lsap address is within cir rang */ 
f/x then there 1s a valid lLigical acdress for the Local lLsap */ 
/x Fetch a2 pointer to the local LSA? table 
/* IF LSA> exists in LSAP directory and LSA? state is in INUSE st3te 
/« THEN : xf 
/x Fetcn pointer to lsao name in Ltsl 
4/* Call search procedure to deternine if 
LSAP already activated for SAP «/ 
/*x* YF &Kemote LSAP 1s not activated alreaacy for this SAP */ 
/* TrheN x/ 
f/x Search remote SA? directory for remote LSA nane «/ 
/x IF Lsap not defined in directory « f 
f/x THN there 1s an error x f 
fx Set status to indicate remote 
LSAP are reacy activated for this local */ 
/* ExLS€ Activate remote SAP for this Local */ 
/* Set status to tinaicate successful LC3B « f 
/x* Fetch a pointer to the remote2 LSAP table « f 
/x Call procedure to fetch the next available 
remote LSAP entry */ 
f/x Set pointer to remota SAP tanla into activate 
of Local LSAP table */ 
/x Increment count of numoer of activates 
-_ existing for this remote LSA? x/ 
( 7 /x Set logical address 
into LC3!: for the Remote LSAP xf 


/* over write the logical addr long word */ 


af 
«/ 


«/ 
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a # 
fx =NDLTE ef 
fx =L3& Remote LSAP already activates for this SAP */ 
f/*« set logical acsrass into LOSI for tha Remote LSA / 
/* Set status to indicate remote LSAP are 
ready activated for this Local */ 
fe ENDIF */ 
Je ELSE Laca3kl L3A? nor 
av3ilasle for servic? or nonexistent */ 
fx Set status to indicate 
Local LSAP 15 Unavailable or nonwrexistent */ 
f* ENDIF af 
f/x end first if «/ 
Je ELSE Local LSAP not 
availasle for service or nonexistent * f 
f/x Sat status to indicate Local 
LSAP is unavailable or nonwexistent / 
f/* Raturn xf 
ao 


‘ i 
ey 
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HIONZYHELL 
Local area Network 


AL LINK CONTROL 


mejaous interface nodule 


nk * Cooyright: Honeywell Information System 
ket ALL rignts reserved. 


kee 

wk Cereat2 dates 
k & Sy: 

wwe Diseriotions 
xk 


a4/2578%5 
Me. Lu 


(: Functions & Parameters: 


coat 

ke 

te & Revision #: 
kk ® Dates: 

wks sys 

kek Discriptions 
wee 

kK gevision @&s 
we te vates 

wa dy: 

eke VIiscriotion: 
xk« 

Rk 
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f TITLE: 


FUNCTION: 


ACTIVATE LSAP PROCEDURE 


Receives an activate LSA? request mess3ge » 

local lsap raauest cause a searcn of the Local LSA? 
Jirectory to insure the LSAP exists and the LSAP 

Ras not oeen previously activated or in a state 
orohioiting service to the user. Remote lLsaod requests 
are also checked to insure the LSAP dces exist. In 
additions a pointer to the remote LSAP table 1s aglacad 
in the activated L3AaP directory of the Local LSA?P. 
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fr 
Me # 
© : 
x INPUTS Pointer to mailbox messajze 
* Pointer to Layer instanc2a table 
¥ 
. QUTPOTS 
EER EBREARABASRAEAASESRESSESERAEEESEABASEESEAESEESBESESEAASESAAEREREAREEARSESARER ORS SE OB 
«x f | 
ix 
wkenekexe NEID TO REVISIT THIS IN ORDER TS SUPPORT «uxennne 
kexkeeke AN ACTIVATE REQUEST FROM A NETWORK LAYER kk exawe 
wef . 
/* Cast on activate transaction block message 7 & f 
f/x [TF layer instance state indicates tle not 
registered with MAC (Cstata=NuLL) «/ 
4* THEN «/ 
/* Fetcn ocinter to lsad name in LC&lI «x / 
Je Call saaren procedure to caternine if LSAP exists « / 
f/x IF LSAP exists in LSAP directory ana LSA? state? is Nulled af 
/*x THEN / ee 
/~ Call mac_Lactivate orocedure to activate WAC Layer ot 
fx Re~issue activate nessage to the Lic_mailbdox xf 
f/x ELSE LSAP doesn't exist x f 
/* Set status of LC3I to Indicate bad LSAP «xf 
f/x Set completion word in the LCETI af 
/* Request DMA services to transfer LC3 | af 
/ This is one of the difficult errors ta nanale « f 
/* ENDIF xf 
> [me if xf 
fx CLSETF Layer instance is tn the INUSE state xf 
f/x 30 CASce on venue to determine whether a 
remote or Local VUSAP activate *«/ 
f/x CASE of Local venue af 
f/* Call procedure to Activate a Local LSA? for this request *«/ 
f/x Set completion word in the LC3I xf 
f/x Set status cf LCSI to indicate 
layer unable to support request « | 
f* Request DMA services to transfer LCE «f 
/x This 18 one of the agifficult errors to hanagle «/ 
fe Set status of LCEI to indicate oneration status « / 
/* CASE of Remote LSAP : i An 


/« Call procedure to Activate a Remote LSAP for this request */ \Y | 


4x Set status of LE3I to tindicate ooeration status */ 
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fw JTdectwiSs uNnxnown venue «/ 
/x Can this raally nacpen and not 32 
oreaviously caetactad ? x / 


Je Set status of LCSI to indicate 5434 
function soecific function code x«/ 


Je ENDCASE « / 
fe Set completion word in the LCSI « / 
/* Raacuest DMA services to transfer iC3 xf 
/ TRIS i185 one of the cifficult errors to handle « f 

f/x ELSE layer instance not able to Support request xf 
f/x Set status of LO3I to indicate Layer unadle to support request x / 
/x Set completion word in tne LCBI «f/f 
f/x Request OMA services to transfer Ltd « f 
{x TAIS 718 one Of the Gifficult errors to hancile xf 
fx ENOTE | wf 
f/x Return | wf 
fx Lhe _lme_ac *«/ 
ee ieee ee ee RP EE RARER SERRE SSAEAASAS SERA RS RRSBARSaRESSPAASALZABRASAAA AAS £ & : tkkekaxkkeen/ 
ie Se Wee ACTIVATE LOCAL LSAP PROIC=IDURE 
FUNCTIONS Receives an activate wcSA® request message for. a 


Local LSAP. 

Tha request causes a search of tne local LSAP 
directory to insure the LSAP exists ana the LSAP 
has not deen previously acttvatea or in a state 
ograhioiting service to the user. 


INPUT: Pointer to mailbox message 
Pointer to layer instance taole 


i 


CUTPUT: 
fee ee He I IR RK RI KR HR ERR REE RE RRR KEKE KE KKK EK 


xf 


/x Fetch pointer to Lsap name tn LCSI xf 
f/x Call searen procedure to cetermine if LSAP exists x f 
J« TF LSAP exists tn LSAP directory and LSAP state is Nulled x / 
/« TREN «/ 
/e Fetch a pointer to the LSAP table «/ 


f/x D0 CASE on the major state of the LSAP to determine 
actions reauired 9 «/ 
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f® CASE OF THe 


/e SET LSAP TO A MES 


LSAP state is uINinitializeca 


CLSA> major state 15s null) « / 


NEcO TO 2EV13517 


ASUS INTERFACE «xx 
FOR NETWORK INTERFACE *#/ 


fe Set LSAP state to INTUSE and OrPerational 


f*« Set Logical adgress into return messajze or LCS x f 
fe Set nax number of sytes in PDdU & f 


/x Set reaa and write credit valu2s tinto Lc3 «f 


f/* Set status to Indicate successful operation 


f/x SASE of LSAP state 15 already IN-USE */ 


/* Set logical acdress into return nessage or Lt? «/ 
/*« Set max number of osyt2es In PU «/ 
/* Set reas ana write credit valuas ints LC3 xf 


f/x Set status to in 


fx CASE of LSAP is not available for service CLOCKED/D0WNeetc.) */ 


f/x Set status to insicate SAP is unavailacle 


Qicate SAP is alreacy activated 


fx ENDCASE «xf 
f/x ELSE LSAP is AON existent x f 
/* Set status to indicate SAP is bad «f 
/*x ENDIF | 
fe RETURN «f/f 

} /e act ll_tsao */ 
LMM RIM KK RH RE KR KKK RK RE KKEKKKKAKREK EK KEK REE KMKEK EMER KE KK KKK KKK / 
/* 
of TIYLE: ACTIVATE REMOTE LSAP PROCEDURE 
*% 
© FUNCTION: Receives an activate LSAP requast mnessage sz 
x Activate remote Lsap r2quests ar? nade witnr respect 
te to a local LSAP. The Layer instances Local LSAP 
* Sirectory 1s checkec t9 insure the local LSA® 
* PxistsSe If it exists then a check is made on the 
* Local LSAP activatea remote directory to insure that 
t the remote has not peen already activated. The 
* State of the remote LSAP is set to Activated if not 
* already and a count of the number of activates 
* received 1s incremented. Finally a pointer 
« to the remote LSAP taadle is alacead 
® in tne activatea LSAP directory of the lLocat LSAP. 
bd 
ie INPUT: Pointer to mailbox message 
* Pointer to Layer instance taole 
x . 
* OUTPUT: 


«/ 


«/ 


ep~ 
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.- 
TLE rcrrrTLrLrrTrL LTT et fs RRR KREMER ER EK EK EK KH KEKE REE KRREEKRKKKKEREK KK EKEK 


«/ 


/« if Local Lsao acarass 18 within cir rans */ 
fx Chen tner2 is a valida Listcal acdress for the iccal Ls30 x«/ 
f/x Fetcn 3 a01Nter to the Local LSA taole «/ 


fe TF LSAP exists tn LSAP cirectory and LSaAP state is tn INUSE stata */ 
«x THEN «| 
/x« Feten pointer to lsao name in LC3! * f 
/x Call search orscedure to aeternine if 
LSAP alra2ady activatad for SAP «/ 


/* Search remote SAP cirectory for remote LSA? name « / 
/* ITF Lsap not cefined tn directory x / 
f/x THEN there 1s an error «/ 


f/x Set status te Inaiticat2 renote 
SE Activate remot2 SA® for this Local */ | 
/~* Set status to indicat2= successful LCt3 xf 


f/x Fetch 3 pointer to the ramot2? LSAP taole */ 
f/x Call procedure to fetch the next 

f/x S2t aatinter to renote SAP 

/x Increment count of nunbder of 


Sie 
i } 
\ f 
\ 


/* Seat Logical aadress 
into LCSIl for the Yencte LSAP « / 
f/* CLSS Remcte LSAP already activated for chis SAP x/ 


fe Set Logtcal adadress into LCSI for the Remote LSA */ 


/* set status to indicate remote 
LSAP are ready activated for tais local */ 
f/x =ENOLFE */ 
} fw jf wf 
/x ELSE Locat LSA? not availanle for service or nonexistent */ 
f/x Set status te indicate Local 
LSAP 38 unavailaole or nonexistent */ 


f/x ENDIF wf 
/x ana first rf */ 
fx ELSe Local LSAP not availaole for service or nonexistent */ 


/x Set status to Indicate local LSAP is unavailasle or nonwmexistant «/ 
/x Return x / 
57 fx act_r_lsao x*x/ 


FM HHH KKK KK RRR KK RRR EKER EK KREEKEKERAKRKKKKKEKKKKKKKEKEKe / 


[RSA S aa SSeS SSeS Sears == Mase ousS: INtert ace SHH ses s$5 SSeS See eS—=> 67 


/*« The request to OMA a LoeI fron the L4& to the LACS has returned */ 


fe 
( TITLE: SEND DATA 2UFFER T2 Lo PROCEDURE 


“ 


* FUNCTION: This routine reaquests the OMA services to transfer 


Seo 19 09:04 19590 JS/usrfdvls/liclodt/ilc_meaga.eceogl %age 6 | 
a. os 
a3 data ouffer to LS namory. Data can 52 transfered in 

3 ways: tin the LOZ ttsalfs to suffer descrined sy 

tna Llc, or into buffers soecifed sy a buffar descriotor 
90Intesa te oy the LCs. 


INPUT: Pointer to MAS aata indicate message 
Pointer to the LOSI transaction alock 
Qointer to the Layer instance tadla 


OUTPUT: 


RH RAR AR HH MH HR 


RRM WK KKK KKK RK KR MRK KKK K RE RRR REECE KKK KERR KKKKKR KKK KREKEEREK 


« f 


/* CARRERE E DSRS WHERE EREE ECAR SEEKS ERE ES OO Rea EK RRO 

* This message has been returned from OMA services. The follcwina 
x code will check the resuits of the transfer request and if it was 
* successful. 

RRM CK KK KR KE EK KKK KEK RE RK ERK CR REKK KEKE KEKKKEKREKKEKEREKKKKKEKNKKEK 


x / 


/* OG CASE on the tyoe of aata buffer in LCBI «ef 


f/x CASE of data buffer contained in the LCE x / | 
/*«data tin lebs stata ouffer transfer x/ i 
eed 
/=x for call rev_buf_to_lé no soolem seat */ 
f/x set the reag credit count for Leb user flow control */ 
f/x set remote Logical adcress */ 
f/x Set the L.C3l completisn soit af 
fe get correct ouffer and return «/ 
f/* CASE of data buffer pointer(s) contained in the LCsI */ 
f/x Regu2st the suffer be transferred to the Ld */ 
/~ Have the message return to tne OMA gone matlrdox */ 
f/* Set priority to normal */ 
/x Set the nunber of cd cuffers xf 
/* Set a residual ranse pointer to aoint to 
suffer CO residual range xf 
f/x Initiailize total range to osdu minus Ile heacer «x / 
f* OG FOR all buffers in tha LC3! xf 
f/* Set the Lé Suffer agescriotors x/ a 
ae 


f/x set the L6& buffer range «/ 
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[ome RK HK KK RK RR KKK KKK RK RE KKK KKEEK EKER EK ERK RK KK 
*« There is a oroslam if tne total range exceeas 32K words 

me fortunately LE will always 3e Less Sut 
* DC wt NEED TD VALIDATE RANGE and 

« WHAT AQAODUT Lis FORAAT ? €32 or 19 adits) 


& ana wRrAAT A20UT LOX FISMAT - Short now 
RI RRR KK EERE KEKE KEKE RE KEKE KER KKK 
x f 


/* Set the restaual range and uodate total ranjze «/ 
f/* IF the total ranse ts zqual to zeary * f 


f/x THEN Set residual range to 
equal tha wholes suffer */ 
f/x eesriptr */ 


Je FLSE IF total range is less than the ouffer «f 
/e THEN set residual rang? equal 
to buffer minus the total range */ 
f/x Set the total rancea to z2ra*/ 


S$ zero *f 
ex set restdual ranse to zeror/ 


7 /* Set the total range minus tne ouffer size x/ 
( , fe ENDIF « f 


fx Decrement the resiaual range 
pointer to point to the next */ 


fe ENDDO «/ 


fx Set ouffer fron (lLe_ttrans block into dma message */ 
/x Clear channel and tntarruct level x*/ 


fx Claar all remaining fields */ 
f/x Send tne regu2st message to OMA Services */ 


/* soectal routine for ilc_trans release? */ 
+ /* else if full */ 


fx CASE of a buffer descriptor pointer contained in the LC3I */ 
/* Set invalid status in the LC3SI */ 
f/x set the read credit count for led user flow control «/ 
f/x Set the LCEI comoletion oit f 
fe Return the LCSI to LS nemory */ 


fe CTHeRWISE */ 


Tok He te eH IK RR RK KKK AKER ERR KKE 
( * Can not decode the ouffer tyoe into anything 
LY x that can oe processed by this function. Unodate the LC3I 

* status to reflect the prodslem anc return the LCSI to 

« tne L5. 
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RRR RH RK KEKE RHE MEK RK RK KERR RK MRR KEKE KK RREKKEKRK KKK EK 


te f 
4x Set invalid status in the LOSI «/ 
f/* set the reag credatt count for tes 


the LCAI comoletion ait 


/* Set 
eturn tne Leal to L5 memory */ 


fx R 


Je ENDCAS: «/ 
? fe switch «/ 


> /® sand_nuf_to_l> */ 


user flow control 


x / 


af 
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| om we ee KKK KEE KKK KEK RK EEK RE RE HKKKKKEKK KKK KEK KK 
KWMERKRHEKRKE KK KK KEK KK KEKE AEH KER RHEE KER HEEKRKEK EE KEKAREEKEKKEREK KKK 
a . 
wrt 
Rrwe« 
fee x HONEYWELL 
. a 
xk * Lacal Are3z Network 
xe 
xt & Logsicaktl LIN «K CONTR De 
ewe 
kt LAY = R 
wk & 
me d2nus module 
x*xe2 
ek «€ 
«% x Cooyritgshts honeywetl Inforsmation Systen 
tex ALL riants reseaervec. 
wk « 
ata! Cereate Date: 1/25/7854 
wk sy? | We Lu 
wk Discription: 
xr 
FEunctions &« Varameters: 
nak 
kK «® 
kkk Revision fs: 
te & Date: 
ke * 3y: 
we « Discristion: 
kk * 
kk t Revision Fe 
ket Yate: 
Kee 3ys 
ke« Discrigtions:s 
nn x 
wwe 
(Soa ERRRAERARRARSRABRABABALARARDSRASBARSA AAA AABABRABRBOASRASSRASRSALSRSAERALA SARA SSRASBASAASA S 3 
RMR MRAM CHK RK RRR RHR RRR K RRR RHE RRREK KK RK RRERKEKARKEKKEKEK 


xf 


LH HH HR HHH HRI HK KKK REE RKEKCREKEREKKEKRKAKKKEKKKE 
x* 


eX . ‘ 

& This module is using for deougging software creak point 
x % set uo and othe tool for deougsinge the entire nodule 
«* and the relatea desugging statements in the tle layer 


codes shouls all take out. 


I believe tnis 18 tne more efficient way to cevelop 
softwares. I t will oe proved. : 


Autho: M. lu 


xk 


RRR RK RRR KK RK KH KK EEK RE KR KEE KKK KERR ERK KK ER EK KERR KREKKKEKKKKKKK EK 


«/ 


LRM MMM HH KK RR EK EKER KEKE KKEKREKEKEKEKAKKKREKEK KEKE KK KK 
« & 

allel Software (CC) sreax points rounte 

« * : 

x 

TEE PRRCRBRSESESLESLESLESESSESLE SELES EASES SLSR SSAL LESS SS 


« f 


FR RSRSEBDASEESSEELESSESASSESELELELSAS ESSEC RSS ASSSE SE SALAS SL ES 
ie | 

®t print L38c rounte 

kk 

n« 

Rieke eK KK ea eK REE RK KR KKK KREERKK EK EK 


« / 


PAE RERECREREEAESSESCSLESSESSSE SELL ESE AES ESELARSESL LESSEE ASS 
& & : 

xr 

* orint PCS rountea 

x* 

ew 

(eee eee SRARABREERABD SSS RESRSaREAS SLE SBASLAARARSOAASRALRSA AS 2 Oe ® 2 


ef 


FADS ERESECSESRERERESEAZALASRSLELESESLESE SR SCRSERS ERE SSE LSS SE SY 
xx 

x* 

a print ECS rounte 

xx 

“xx 

(Leet ee eee ReEEASAESRESRER ASA RRABSSASRARRAZSEREARS ASA AAA LAL SS 


«f 


IAZSEBSERESERSSCSELESESESESESAESLSSEASE SESE SLES SES ES SSE LES SS 
<* 

* We 

tt print message rounte 

®t 

& 

See eeeSeEEeE REPS ELE SESESESISS ESR SL SESE SSL ASRS ESSE ES 


«f 


LM KH KR KKK RRR KER REEREK EK KKK KEKRKKK KKK KKEK 
x* 
“x * 


&* print status rounte 
x * 


— 
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a 
He HTK IK RE KR KRERKEKKKKKRKKRAKKKKREKK 


*/ 


LHRH KKK KK RK KEK RE EK KEK EK KK KK EKER KKK K 
ne 

RK 

* print startup parameters rounte 

te 

ex 

RHR RK KKK KKH KEK KKK KKK KERR KEKE KREKKEEREKKERKKKR EK 


«/ 


he 
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, a 
YC Y 
JM HH HK HR KR KR KEK KEK KEK KKK RERKE KR KEKKKEK KK EK KKK KKKRKKKE KKK KK & 
fot RRR KKK KEKE KARR KERR K EK RaMMEHMREEKEKKKREKKKEKKREKKKER KKK 
wx & 
xx 
ek HONEY wok 
a ae 
xk 
ke x | Local Area Network 
we 
od! He OG. IS eG: SAP L IN K CONTROL 
eke 
we t LAY &— R 
xx « 
te ke common module 
“wx 
Lo me 
exe Copyrights Honeywell Information Systen 
ka & ALL rights reserved. 
Kk « 
xk & Cereate Date: 1/25/7385 
kk 3y : de Oshaughn 
wee Discriotion: 
RR* 
xk Functions % Parameters: FS 
x ke & s 
eRe 
xk t ReVISTON 4: 1 
ke Date: 3/25/56 
ck & Sy: Me Lu 
kk w DIScristion: 
Kxn% x 
«em Revision 4: 
ke Yates 
kx € Sy: 
ck R Discriotions 
ek 
, me 
RMR KRM RRM MK HK RH RK RMHEREERRKEKERE EHR KEKE REKEREKEKEKEKKEEKRKEKERKREK 
REC KERKKKRKK RK RK RK RK MK KKK EKKKEKKKEKEKRERKEKKKK ERK 
xf 
[X Serer es S25 23S ese Seen ess "— Lil SAP Component “+r ss =< sss Sse 4eSse—"4/ 
f* -\2eeeeeeeeaSERSEARAREREBSARERRRE RE SARL ASAESAAASSARASAALE SE SAEASE RSE LESS SC FS 3 
* A orocedure to return a ‘not active*® status in tne LOSI that has 
x just peen transfered and tne LSAP was not active. 
4s | 
* The parameter is a potnter tc the Lle transaction. 
% 
* FUNCTIONS Lists: 
® Lsan_not_active (llce_trans) i 
* LLC_ TRANS *tle_transs * A pointer to the tle transactton * | 
bd 


TOLOsCmoxptr-ret_msx,lica_o) 


Tf. 


AAR AR RR Re Oe ke em 


% 


te 


+ | Milian + + ee eR RHR 


) 
a 
~~ 
pow 
vw 
@e 
ix3 
J 
—w 
vw 
cY 
oO 
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4 
‘ 


S32 *moxotere 
3idD ret _mox,e * Tre return mailsox« TD * 
wICA w«lica_o-r * PsINtar ta the orsc2ss variables * 
raturn_leoviC€lle_transvret_noxslica_o) 
LLO_ TRANS xlle_transs 
“™3iD ret maxes * The return matlscx [D x 
LICA *«lica_p-s 
return_suffti(tle_transstlica_o) 
LLO_ TRANS el le_trans, 
LICA *xlica_ps 
Leoi_to_L5(noxotrslica_o) 
ASG emoxotts 
LICA xlica_os « Pointer to tne orocess variables * 
buf_to_lac(mbxptr-lica_9s) 
MSS wembxotrs 
LICA *Lica_p-s 
buf _to_lS(moxptrelica_9) 
MSG *moxoatre 
LICA exlica_op-, 
snort tle_alarm(nem_blks-mss_type-alrm_per) 
AMSG xmem_olkse *« Potnter to the memory olock * 
usnort msg_types * LLC message type * 
u_long alrm_pers * Alarm seriod * 


[2a SREeREeRARERARARARABRASEAASRAERALASRASLASR RSS ARESAARS RAL ER ARARSDASASE SAAR SARA L ES SE 


/* A yointer to tna Lhe transaction */ 
/« Kernel return codes */ 
/x Set tne status for LSAP not active */ 
4x Lsao_not_active xf 


> GD DW ee SO Oe OE OOOO OOOO aaa = ma = Magjgabus Interface 2 ow OD ee OD Gn OS OD 2 en OO ee ee ee ee ee xf 
eee eReeeReRERBOaDRBEPASBSOERELES EEE SaERASPERASZAREALAERARASASLALSAARAAESSABRSARSSARAALR SAS BES | wf 
An IO0LD request message x/ 

Tris message is from the megasus interface? software and states */ 


VICES ReCSIVE TOLD MESSAGE and REAVEST LOGi FORM LG PROCEDURE 


FUNCTIONS 

An I0LD command was issued sy the LS for this board and Instance. 
ALL function specific function codes for the LLC layer 
and instance are all routed here at signin time. The object of this 
code is to find space for the LORI and request OMA services to make 
the transfer across the megasuse The message will oe returned when 
OMA services comoleates the transfer or finijis a reason why the steo 
cannot oe oerformned. 

A LLC transation block 13s used from this point on to process requests. 
The too end of tna olock 18 a union of message tyoes used to DMA tne 
LCSIv to D¥A any buffers involveds and to requast L_DATA.arequest. The 
instance, the LSAP tables ana the LC3I all have nointers to them carried 
along with the transaction bdtlock. 


a RF RF HF RK 


® 


17 


(198227 1985 /userlavic/lle_pat/fiic_c: 


oO 
a) 
=4 
a 
OQ 
po) 
a 
i) 
t 
uy 
Ch 
eo 


Indut: Potnter to I3tL) tess3ag2 
Peturn matiloox ia 
access £9 common sysStan Ranagenant cata structur2s 


Jutout: =rror status 


SOP eEREaRaaRASSAELSRA DEAS RSASLEL ESS ARRAS SERA RSAARS AA BRASR EEE SEAS RA SSS SRERA RARE OSS ES @ 3 


«/ 


{re 
ix 


The return matlasox ID «/ 

Pointer to the process variaoles x«/ 

f/x Pointer to tne LLC transaction blcck */ 
4x Kernel error codes x/ 


a 3 


/ x 


/* clear block pdinter x/ 
/® clear block countar */ 


Get some soace for a LLC transaction «/ 
f/x raturn to the calling *«/ 
fe 4 ZRVRETUIN *¥/ 
initial all null */ 
Set the siz2 of the transfer per tne [0Ld request *«/ 
Save the Length for the return trio Later */ 


Save the channel sits for the return trip *f 


Get and save the aointer to a memory dlock 


tne size requested olus queue pointers */ 


/* 


IF no space is availaola */ 
4x raturn to tne calling x/ 
fe 4f ERR_RETURN */ 


ENOIF */ 
4x clean up all mem Lle_trans->lcoi_olk *«/ 


Point to the L.C3I block */ 

Have th2 message return to the supplied nailbox */ 
Set request type to *move LCa to LACS e/ 

Set the Lo adgress from tne IDLD request */ 

Save the L6 address for tne return trip later */ 
Copy channel and level information */ 

Set priority to neem xf 


Clear all remaining fields */ 


; 
\ 
ae eo 
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f/* Send the requ2st mnessage to DMA */ 


/e raturn co tne calling «/ 
fe 4# 22 RETURN */ 


f/« Free the IQVLD request massaze olock */ 
Je An =ERQIOR CODE SHOULD JE PART JF THE RETURN ef 


fe RETurn nf 
4x TOLtds xf 


fee K KKK KK RK KEKE ERE REE KKEREREKREKRKK KKK EKER EKER EKER EK KEK & / 
in —_ <2 <p 22 a <2 ap 22 oe 2 we Oe Den @ ae 4D aw @ ae 2 4m 2 oS eas Ma S a Jus In ter ¥ ac e <2 << <> aap GP <p GD GD a aD 4b aD «aD aD a aD ae > mn <P ap «4 ap =D * / 
fe A common function to return LCO2I slocks across the megacus */ 


* TiS ss RETIRN LCZSI TO L6& PROCEOURE 


FUNCTION: This function receives a transaction olock containing a 
a LC3ie It creates amessage to for the OMA software to return it 
to Lé&é memory e Tha LOC2I status must have geen set oy the callear 


Inout: Pointer to transaction block 
Return mailbox ia : | 
access to common systen nanagsement data structures 


x Sutpcuts error Status 


WHC W KRM KH RKRRERREK CRE KK RK RK KCRREKKEKMKEKERREEKREKRERERKKEKKRKKKK 


«f 


f/x Tne return matloox ID */ 
/x Kernel error return code */ 
/x Convert the message into a DMA LC3SI request */ 
/* Have the nessage raturn to the DA done mailbox */ 
f/x Set priority to nornal */ 
/x Point to the LC3I to ve transfered */ 
/* Declare the Length to be transferred */ 
je Move the L6 memory address to the DMA request */ 
f/x Copy CPUs, channels and tevel from LCSI «/ 


f/x Clear all remaining fields */ 


/* set error datectian oit for level 6 software */ 


/x Sonu the request message to DMA services */ 
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f/x raturn to tne calling */ 
fe Gf ZRR_LRETULIN */ 
f/x Return xf 
/e raturn_leooy */ 
/ 90 9 He He 90 HOT Te IIT 1H I KK TI Re Ke RRR KKK KERR RK KK ERE KEK KEK / 
ix a a 1 an 1 am sham Sh an oD a 6 a 4) an 4) on 4 4D @ oe ae we Mejaous Intertf3ce 2 ap «mn aw <a am om ss. re ee ee ee OY yy ah VP am > a a aD xf 
/«* 
* A common procedure to return message sutfers t2 the LS memory. 
x The parameters passed ares the LLC transactions tha tnaicatison messager 
* ana che variatles for LLC. 
He He He He He Me Me WH HK HK HK TKK HR IK MK HK RH RHE KUERERKEKERKKKKKKKKY 
xf 
f/x Kernel return codes *«/ 
/x Convert the tle transaction into a suffer OWA raquest */ 
/* Have the message return to tne DMA done mailcox */ 
f/x Set priority to normal *«/ 
/* Set the ouffer count to Tee Note: Tnere may ce nore in the future. */ 
f/x Set the LS ouffer descriptors */ 


f/x Set tne LS buffer range *x/ 


fx Copy CPUs cnannels and level from LCST */ 
f/x Clear all remaining fielas «/ 


f/x Send the recuast nessage to D¥A services */ 


/e return to the calling */ 
Je JF ERR_LRETURN *#/ 


f/x return_suf «/ 


LH HK KR KR KK KKK KKK KKK HEE KEK KEK KK EREKREREKKKKKKK / 


[k HERA KAS ea ASS eee Hae MOGaoUsS. I Ntertaee HSS TSS sess > a2 seSer = o= &/ 


{x The request to DMA 4 LECI to the Le Has returned x/ 


{x 

* TITLE: LCBI TRANSFER TO LS COMPLETED PROCEDURE 

x 

x FUNCTION: A receive s xmit or Lme 

* 7 L€3 data request has been completed and 

* tne LS memory LC3 has deen undated by the LACS DMA. 

* This routine releases the LACS memory for the LC3Is 

® for the transaction olocks and the buffer descriotor 
* olock Cif there is oneds, for the data dsuffertcif there 
* 13 oneds and a Nac data indicat? messaygel(if there is 
* one). | 


$e. 17 10227 13985 


C 


iN?PUT? 


OUTPUT: 
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Painter to LLC trarsaction alack 
Pointer to Layer instance taole 


error Code 


SRE RERERE RARE RERSESSERERERE SER SELESR SERS ERASERS RSESESESELCE SERS SESE SESE SES SS SY 


xf 


fx Potnter to the oroc2?ss variaoles *«/ 


IME RERPASERSEERESEAEERASESLESASSERSRESSE SESS SE EEAE LES ESLE SALE SESE RE RASS 
* This message 1S DeINgj feturnecdc dy IMA Services aftar LLC has mac2 
® a Pequest to transfer a L.C3 back to the La. The following code will 


* cneck the results of the regquast and free the message if all went well. 
r2eoeeeOSRSaERESOERASZALAEE EE EREREREARERRBRABRRSASAARELASSLERE SERA AERSLSA SE SP RABARSSLAL ES & 


af 


/*« Pointer to the 


f/x IF tha transfer 


fe ELS<e 


a / 


/x Decide 


fx =NOLF 


/x Lebdi_to_Ll6 */ 


« / 


LLC transaction block «/ 
was successful */ 


£9 Gdo wttn OMA failures at this point..*/ 


( fe te Sete Se tee tee Re he tee eK KER KK ERR EEKRR ERR KK KKK KEK KKK ERE KER EK / 


ee ee ee a ee 


® 


a 


TiTLes 


FUNCTION: 


INPUT: 


YVUTPUT: 


CLEAN LLO_L TRANS 3LO0CK FUNCTION 


A receive »s xmit or Ime | 

This routine releases the LACS memory for the LC3I- 

for the transaction plocks, and tne buffer descriptor 

Slock Cif there 1s oneds for the cata auffearcif tnere 
1$ O9N@)+s aNd a Nac data inagticata messagelif there 1s 
One). 


Pointer to LLC transaction block 


trror Code 


2 oe ee eee eee eee ee eSeRSRESAASLARSS ARREARS SRESSEARARERARSASASZSESASLALE SR ASSAARE SSE SSS | 


xf 


3 


fe Pointer to the trans blocx */ 


« IF the transaction olock points to service bLock not NULL * 
* THEN release the serv * 


/* TF 


<NOTS * 

the transaction olock points to mac data indicate message xf 
f/x THEN release tha mac indicate message ff 

cNOIF : xf | 


ed 2 
mn 

'@) 

~ 
~J] 
= 
qd. 
oe 

tw 
~~“ 
aad 
» ¥) 
¢ a] 
© 
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/« IF the transaction glock points ts 3zata suffer «/ 
f/x THe releas2 tne aata suffer «/ 
fe ENDIF | 7 « f 


f/m IF the LOSI ootnts to Leo «/ 
/« THEN reteasa the edi *«/ 


fw ENDIF as 
fx TF the LCszr osints to buffer sescriotor xf 
f/x THEN release the ouffer cescrictor xf 
fx ENDOIF xf 


/x Release the LLC transaction bSiock */ 
/*e trans_clr */ 


TEA SEAERSEESESESESEABRESESESESESESSESESE SEALE SESAESSESES ES ESE ESE SSA SL OLA LSS ASSES LSS 2 ws 


f/x The reguest to D¥A 3 ouffer from the Lo n3as returnes */ 
To te Me te TH RH HK HK RK KR KK KK RE K KEK KR EKKKKREREK KKK KE KKEKEKKKKK EK f/f 


/* Pointer to the tL_-pdu */ 

fx array index */ 
fx RRM KM RUHR RRM RHE HK RR ERKE KK REM KEK KH EKKKEKKEKKKEKRKEKKEKRKKKERE 

* This message is returned by DMA services when it completes the 

« transfer of a vuffer from tne 15 to the LACS coard 3s part af a 
* transmit transaction. Thts step will aga the Lic Layer: addressing ee 
* to the message and send the Loadu to MAC for transmission. 

AE RPeRERAOSOSSAEAEAERSaSERARERRERSASAR SSE RARE ARSRAERSRAALRAZLRSSAASASSP RARER SL ASS 3 


xf - 


f/x Pointer to tne LLO transaction Slack */ 
f/« <ernel return codes */ 


Je IF the transfer was a success */ 
/* Cnange the transaction into a L_DATA. request +*/ 


fe Send to the LLC layer «/ 
/x c af 
Reoort a DMA failure «f/f 
f/x Set che LCOS status to conpleted */ 


f/* Return the LOBI to L& memory */ 
fx ENDIF wf 
/* buf _to_lac */ 


TH WH HHH KKK HRI KKH KK HK KK KERR REE KEKERKKKKRKKKKEKK tf 


/* The request to OMA a buffer 6 the Lé has returned ef 


[REERLRE DADE CECE EREEREEA WE OERE EERE RE EER COANE AED ORO EOS CE REEEE ESR ER EY —_ 


Ney 
/* ‘Ae Ree RSARERSaASEARARABRALAZAESLAALERSRSERERAAARRPALASRALE SRSA SASRERBR SSL ASAE SL ES S 
* This messag? is returned by DXA sorvices when it completes tne 


We 
Dp 
(So) 
a 
~y 
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* transfer of a suffar from the LACS board ta the LS as Dart of a reaag 

x transaction. This steo will set the status in tne LOSI and resguest OMA 
* services to return the L_C-o to tne Li. : 

WMH WRK RK KKK KEK ER EME KH RR EK KR UR ERK KKK RK RE CREEK KEK EKEKKKRKEKREKKKEKEK EK & 


«xf 


/x Pointer to the LLG transaction biock */ 
f/x Kernel raturn code *f 


/* Indicate LC3SI comoaletion in tne status */ 


fe Return the LC3I to Lé memory */ 
} {x puf_to_lé «/ 


/~« End of LLC procedures x/ 


(RES ERSESESCMRPASERSERSRARESERLSLESASESSLERSESEE RSS SRS REESE STEP RES ESLER ERS SER ER ES 


jx 


a 


Tnis function will request ar alarm fron the kernel via a 

* messagee The caller must supply a olock of memory the size of 
x» the alarm message CAMSS)- the message tyre for the raturning 

* nessagers and the period to wait defcre the alarm message is 
® 


returned via the process default mailbox. 
Toe ReaSRSaEREERESSEEREASRERARASESESESABRDRSERESRBERSERESABESBEAELALERBESRESEAZASAESSLERSAA SED ES 


* 


f/x Pointer to tne memory bsblockx */ 
f/x ILC message tyoe */ - 
/* Alarm pariog */ 
/x Set the priority and clear the buffer descriotors */ 
f/x Set the message type to aging alarm */ 
fx Set Length of timeout interval in seconds */ 


f/* Request the next aging alarm period */ 


fe Llelalarm «/ 


$23 15 152535 1935 JS/ausrfavip/lilc_pel/ile_event.c.aal Page 1 


ie REMESRESOESSSERSRSaERSSESEL ES AEARSLESALSESL ASR RR SAE SRARSRRASRL RARE SESSA ES SO 
PRR RREBSSROEERERASRSESREELSR SERRE SESSA SSERESRERSERABRSASRSAASPARAARELSOSAR SRA AAAS AS Se 2 
wee 

wR 

eX @ 

kk K HONEYWELL 

a me 

ke Local Area Network 

KK 

ak LoGIc¢caAL LInK  €o3ONTROIL 

KeK 

wt & | LAYER 

Ke 

ket event message module 

wk 

“xXx 

wk Copyright: Honeywell Information system 

wee ALL rights reserved. 

eet 

eR Cereate Date: 5/5/36 

kee dy: Me Lu 

«x Discriotions 

kk 

xe Functions & Parameters: 

xe 

Ke & 

kee Revision 43 

kk Dates: 

x * 3y: 

we Discriotions 

kee 

wee Revision &@: 

kek Date: 

wk sy: 

eR Discriotion: 

Knze« 

eK 

HRM MH KR HRM KKK MRK HK MERE KKK KRHEKKKRKKERKERERKERRERKKKRKKKKKKK EK 
(SaReERE RES REESE SS SRERER SRE ERASE LEASES SARS RARARERAARSE RASS REaRSRSBRSASLSASAA SASL & B 


x f 


LHRH HEREC RRREKKCKERERAKRKERKEKRKEKKKRKRKKK CRAKE KRKEKKKKKKRERKEKKEKEKKKKKKKKKKKKKK | 


/* A LLCO Layer management event message */ 


/* 

« FUNCTION 

* Handling all error anc crash situations. 

* It will eventually grow up to a Large complicate 

oe module. 

* The event messag? recieved by the ile Layer management 
x moaule is of the fornat* 

x _. Layer info 

te _. layer inst 


(? 15 15236 1985 JS/usrfavip/lle_pal/ile_levent.ec.eoal Page 2? 


* _. Layer inter. sel2cter 

© _. avant status 

® 

Ld 

x INP St pointer to event messaze ADOK. 

* pointer to Layer instance tasiea. 
x 

* QUTPUT: 

x 

=f 


[we KR eK RK KR KR EERE RRR KKK KEKER RK KKK / 


/* all function noves to common avent_msg routine */ 
4* ptr to event msg */ 

f/x Yteration index */ 

f/x return code rf 

fx clear clock pointer x*/ 

/x slock size x/ 

fx clear olock counter */ 


fx allocate space for event msgrx/ 


f/x reaturn to tne calling */ 
Je if ERR RETURN */ 


( | f/x if «/ 


f/x clean up all mem msaotr */ 
{x set ud event msg */ 


f/x load layer internal selector darans from (le trans 
Into event nsg */ 


fx for */ 
/x for x/ 


/*® sat ud event status */ 
f* OR 2rror elass with soecificevent code to get event cod2 */ 


/* send event msg to SM -~ use event mailbox Id in LLO_TRANS 
Tf errors, call mexit */ 


/x return to the calling */ 
ERR_RETURN #/ 


~ 
+ 

ade 
~, 


fe Tf «f/f 
Je else xf 
f* (Lle_evimsg */ 


( /* Error status «/ 
~/* Lsad index */ 


fe AM event request nas deen received via LLCO layer management. */ 


seo 75 1533 
f/x get 
fe vat 

[* 
/* 
/* 


/ 
/* 
/* 
/« 
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tn2 Lisaa_taole arr */ 
tdate isap cadle */ 
tsa deress */ 

pur the avant Los ol: e lsac taoleo «/ 
if «/ 
* return not vaiia ted error «/ 

conoleted with error */ 

return tne bad Ltd */ 

yet out nere */ 


f/x alse «f/f 


f/x the common event_msg routine will handle tne event LC3 return «/ 


{* 


{* 


ilLe_lme_ev «/ 


Pointer to activate LSAP message xf 


{xe Potnter to the instance table */ 


fe cointear to avent transaction olock nessace */ 


/* Indeax of remote SAP directory */ 
fx LLCO error status xf 
fx pointer to Lsan nama «/ 
/* 
wkeewkek NED TO REVISIT THIS IN JROER TO SUPPORT «xxxxnx 
kekkeke AN EVENT MESSAGE FROM A NETWORK LAYER tate eee 
«/ 
/*® An event request nas aeen rec2ived via LLC Layer management. 
/« Cast on event transaction olock messaje xf 
/x Set comoletion word tin tha LC2lI 
/e Raquest OMA services to transfer LC3 
/* This is one of the difficult errors to hanal? 
/* raturn to the calling */ 
fe Ff FPR_LRETURN */ 
f/x IF Layer instance state indicates 
tle not registered witn WAC (Cstate=NULL) */ 
/* THEN 
f/x Feten pointer to Lsap name in LCSI 
f/x Call search orocedure to determine jf LSAP exists 
fe ZF LSAP extsts in LSAP directory and LSAP state 1s Nullec 
/* THEN xf 


f/x Call mac_activate procedure to activate MAC Layer 


/* Rewrissue event message to the Lle_mailtox 


xf 


«/ 


wf 


oN 
f , - 
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f/« paturn to the callina */ 
fe (f FRI_LVETGIN */ 


/x return to tne callina */ 
fe 4 292_2=ETUIN *#/ 


/*® return to the calling */ 
fe if ERR_RETURN */ 


fx ELS= LSAP aoesn't eaxist wf 

Je Set stacus of LEBI to tndicate bad LSAP x/ 
f/x Set completion word in the LC3EI xf 
f/x Ragquest OMA services to transfer LCa xf 
i This is one of the sitficult errors to handle 

/*® raturn to the callings */ 
fe Ff ERI_LAETUAN *¥/ 
fe ENDIF | «/ 


f/x ELSEIF Layer instance is tn the INUSE stata xf 
/* DO CASE On venue to scetermine whether a */ 


fe Set completion wora in the LC3I xf 
/* Request OMA services to transfer LCs | x / 
/« This t8 one of the aifficult errors to handle © « / 


f/x return to the calling */ 
fe if ERR_RETURN */ 


fe ELSE Layer instanc? not asle to support request «/ 
/«* Set status of LCBI to indicate layer unable td supcort request « f 
4x Set completion word in the LC3i «/ 
/x Request OMA services to transfer LC3 « f 
/ x This 318 ona of the difficult errors to handle « f 


f/x return to the calling */ 
Je if ZR2A_RETURN */ 


/« ENDIF xf 
fx Return . wf 
+ 4x ite _lme_ev *x/ 
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discription: 


Functions 4 Parameters: 
LiclerrCerrcoderverrmasgreerr_trans) 
snort errcode, 
cnar *errns je 
LLC TRANS *arr_transs 

error cases? 


case 
case 
case 
case 
case 
Case 
case 
case 
case 
case 
case 
case 
case 
case 
case 
case 
case 
case 
case 
case 
case 
case 
case 


SAP_NOT_AVAILASLE: 
SADLFSEFCs 
BAD_LAYER_STATE: 
SAD_REMOT=_SA?: 
ZAD_LICAL_SAP: 
INVALID_FCs 
SAP_ACTIV=: 
MULTIPLE_ACT: 
BAD_R_LSA?_STATE 
SADLLULSAP_STATE 
SAD_BUFF_TRANS: 
BAD_BDI_TRANS 
SAD_XMIT_REQ: 
SAD_POU_SIZE: 
SUFF_LTOD_SMALL: 
BAD_OSAP_STATE: 
SAD_-RCV_DSAP: 
BAD_RCV_SSAP: 
PDU_TOC_316: 
BAD_RCV_REQ: 
XID_XMIT_ERR: 

XID_LRESP_ERRS 

UNKN IMSS JxJ024 * unknown message tyoe * 


seo 


( 


eee 
xk 
kket 
Rw 
Re 
kk 
Rw tk 
RR 
zene 
eae 
eX 
Rw t 
wk te 
Xk & 
RK 
nk 
kk 
wxkkk 
kK 
wx 
“x « 
xn 
kw 


13230 


case 
case 
case 
case 
case 
case 
case 
case 
case 
case 


Paste 


SAD _SM_RM3CK 
SY ORMSOX_ FU 
S40 3% _ Rew 
NOL MEM_ SET 
NO_MEM_ALO 
RT ULC Si 2 2k 
3AD_OMA_Mi0X 
DMA_M30X_FU 
3AD_LC3I_2P 
DMA_BUF_FATL 


default 


Revision &: 


vate: 
3y: 


Disecriotion: 


Revision #: 


vate: 
3y: 


Discriptians 


3x 2C 25 
Jx 39245 
ox ub 27 
9x 302é 
Jxu02y 
Ox? 3c 
jx 3031 
9x3032 
3x3C33 
ox9035 


Renee eH HHH HR 


fusr/avloeo/lte_ral/tle_err.c.odkl Fag2 2 


>M r2aturn mail oox * 
S“ raturn mailoox full * 
Invaitc 3” request * 

setouf coulda not allocat?2 « 
allocate no nem avail * 
return (coi arror *« 

invalia OMA nail box * 

DMA return mailbox full * 

Saji leni ressonse - 519 err * 
DMA of a buffer failed « 


invalid 


Pee REeREESA ASRS AALS RRS REREAREARSRRALBRSSRASZSAASALRAASAASAS AA SEES SASS SS SS 


f/x 
/* 


{* 
i * 


/e counters x*/ 


/x avent code for avent msg */ 


get layer instance tadle 


«/ 


[MEE RP ARERCEE SAREE SRE SSESELE ESE CSAL EERIE ESS EE EERE SESE SE ELSES SE SEL SS 


pointer at the ring for Last message */ | 
/*® ERPR_MSG_COUNT ¥n the 2rror nessage ring */ 
/* ring counter */ 
message «/ 
/* gointer at the cing for Last nessage */ 
/e ERR_MSG_COUNT in the error messace ring */ 
f/x fring counter */ 


f/x save 


Save the 


error 


Save the Lica lp */ 


f« LLC 


LLC 


LLC 


LLC 


LLC 


LLC 


LLC 


layer 
Layer 
layer 
Layer 
Layer 
layer 


layer 


error 


error 


error 


error 


error 


error 


error 


condition 
condition 
candition 
condition 
conditicn 
condition 


condition 


case 


case 


case 


case 


case 


case 


cese 


arr data bstock pointer address x/ 


SAP_NOT_AVAILAGLE®/ 
3SAD_FSCF */ 
JSAD_LAYER_STAT= «&/ 
3AD_REMOTE_SAP x*/ 
3AD_LCCAL_SAP */ 
INVALID_FC */ 


SAP_ACTIVE #/ 


f® ULE 
fe LLC 
fe LLC 
Je LLC 
f« LLE 
fx LLC 
f/x LLC 
je a ae 
Je LLC 
f/* LiCl 
f/x LLC 


fe LLC 


Q 


eee ) 


Layer 
layer 
layer 
Layer 
Layer 
Layer 
Layer 
layer 
layer 
layer 
layer 
Layer 
layer 
layer 
layer 
layer 


layer 


arror 


error 


error 


error 


error 


error 


error 


error 


error 


error 


error 


error 


error 


error 


errcor 


error 


error 


conartioan 
conaciticn 
conaitican 
conaiticn 
condition 
condition 
conaition 
condition 
conciticn 
conciticn 
condition 
condition 
condition 
condition 
condition 
condition 


condition 


case 
case 
case 
case 
case 
case 
case 
cease 
case 
case 
case 
case 
case 
case 
case 
case 


case 


f/x invalid SM return mail ocx */ 


f/x {LC layer error condition case 
f* S™ return mailbox full */ 


fe LLC 


fe LLC 


f/x LLC 


4* LLC 


f/« LLC 


Layer 


2rror condition case 
/*x tnvalid SM request */ 


Layer error conaition case 
/* getobuf could not allocate x/ 


layer error conaition case 
f/x allocate no mem 


layer error condition case 
f/* return teoi error */ 


Layer error condition case 
/* invalid DMA mail box */ 
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MULTISLE_ACT */ 


JAD_R_LSAP_STATE */. 


3AD_L_LSAP_STATE ¥/ 
3AD_3UFF_TRAN ¥/ 
BAD_30I_TRAN */ 

SAD_XMIT_REG «/ 
ZAD_PDU_ SIZE */ 
3UF_TOC_SMALL */ 
3AD_DSAP_STATE */ 
24D _R2CV_DSAP *f 
JAD_2CV_SSAP «/ 
PDY_TCO_3IG */ 
SAD_REV_REQ */ 
XID_XMIT_ERR */ 
XID_RESP_EQR */ 
ef 


ZAD_SM_RMAOX */ 
SM_LRMSCX_FU */ 
—SAD_SM_2£Q «/ 
NOLMEM_GET */ 
NO_MEM_ALO «/ 
availible */ 


RT_LCII_ERR */ 


SAD_DMA_M30X */ 


a : 
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ad 


fe LLC Layer error concition case DMA MICK FU #7 
Je DAA return nailsoox full */ 


fe LLS Layer error condition case SAO_MAC_MSCK */ 
fe invalia “AC mail s0x xf 


f/x LLC layer error concsition casa MAC _MSOX_FU «/ 
/x MAC return mailoox full */ 


f/«*« LLC Layer error condition case BAD_LEAI_RP *«/ 
/* bad edi response - big err x/ 


J/x LLC Layer error conaiticn case TOOLLING_OLCA */ 
/x data too Long to put in led */ : 


f/x iLO layer error condition case DAM_BSUF_FAIL */ 
fx DMA of 4 ouffar faitea «/ 


f/* LLC Layer @rror condition case GAD_R=ESILVE_M30X = / 
fx LLO layer 2rror condition case SAD_REG_M30X af 
Je LC layer error conditicn case M30X_IJN_ERR * / 
f/x LLCO Layer error conaition case M30X_JFF_ERR «f 
f*« LLC aye. Gepoe CONGItION case M3CX_OL_ERR xf 
/* LLC layer error condition case SENDM3G_ERR xf 
fx ULC Layer error condition case BAD_IO_MSG xf 
/* LLO Layer error conaition case BAD_RES_MSXDIR ef 
few LLe Layer error concition case INV_TRANS? « / 
fx LLC layer error conaiticn case QUEJE_FUYLL x f 
/* tLe Layer error concition case DEFAULT_ERR * f 
is Lic iayer error condition case 1 « / 
/« (LC layer error candition case 1 xf 
/x LLC layer error condition case C xf 
f/x switth */ 
fxlilec_event_cad = EVENT_LINDIC, * event indicate mssage */ 


/e event indicat? mssage */ 
/* send event message to system management x/ 


¢ /* end Lle_err x«/ 


f/x central handling for exit conaition x*/ 


seo 18 17152330 1925 J/usr/dvls/ttho_pal/ilclerr.ecepil Page 5 


f/x kernel calls shut down the Lacs */ 
fe ans ilec_exit */ 


Je only return to tna calling. rot eaxit */ 
f/x -2 for all error case xf 
fe ena Liclerr return */ 
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